MaskedTextProvider.Replace 方法

public:
 bool Replace(System::String ^ input, int startPosition, int endPosition, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool Replace(string input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.Replace : string * int * int * int * MaskedTextResultHint -> bool

Public Function Replace (input As String, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

參數

傳回

true如果所有角色都成功替換;否則，。 false

備註

該 Replace 方法搜尋格式化字串中，在指定的起始與結束位置之間第一個可編輯的位置。 假設此點之後有足夠多可編輯位置，現有字元值會逐一替換為替換字串參數 input的內容。

以下條件被視為錯誤。 當發生錯誤時，不會有替換，並 Replace 返回 false。

• startPos OR endPos 參數指向格式化字串的起始或結束之後。

• 格式化字串中可編輯的位置不足以容納替換字串的內容。

• 其中一個替換字元值不適用，因為它無法列印或與對應的遮罩元素不符。

除了回傳值外，此方法還有兩個輸出參數，以提供關於替換操作的額外資訊。

另請參閱

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

public:
 bool Replace(char input, int startPosition, int endPosition, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool Replace(char input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.Replace : char * int * int * int * MaskedTextResultHint -> bool

Public Function Replace (input As Char, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

參數

傳回

true如果角色被成功替換;否則，。 false

備註

該 Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) 方法搜尋格式化字串中，在指定的起始與結束位置之間第一個可編輯的位置。 若找到，該可編輯位置的值會改為指定的字元。 input 以下任一條件都會導致錯誤狀況，導致不執行替換，且會回傳 值 false ：

• startPos OR endPos 參數指向格式化字串的起始或結束之後。

• 在指定區間內找不到可編輯字元。

• 替換字元 input，因為無法列印或與對應遮罩元素不符，因此不是一個有效的輸入字元。

除了回傳值外，此方法還有兩個輸出參數，以提供關於替換操作的額外資訊。

另請參閱

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

public:
 bool Replace(System::String ^ input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool Replace(string input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.Replace : string * int * int * MaskedTextResultHint -> bool

Public Function Replace (input As String, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

參數

傳回

true如果所有角色都成功替換;否則，。 false

備註

該Replace(String, Int32, Int32, MaskedTextResultHint)方法搜尋位於指定位置或之後的第一個可編輯位置。 pos 假設此點之後有足夠多可編輯位置，現有字元值會逐一替換為替換字串參數 input的內容。

以下條件被視為錯誤。 當發生錯誤時，不會有替換，並 Replace(String, Int32, Int32, MaskedTextResultHint) 返回 false。

• 參數 pos 小於零或大於 Length 格式化字串的參數。

• 格式化字串中可編輯的位置不足以容納替換字串的內容。

• 其中一個替換字元值不適用，因為它無法列印或與對應的遮罩元素不符。

除了回傳值外，此方法還有兩個輸出參數，以提供關於替換操作的額外資訊。

另請參閱

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

public:
 bool Replace(char input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool Replace(char input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.Replace : char * int * int * MaskedTextResultHint -> bool

Public Function Replace (input As Char, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

參數

傳回

true如果角色被成功替換;否則，。 false

備註

該 Replace(Char, Int32, Int32, MaskedTextResultHint) 方法搜尋格式化字串中，位於指定位置 pos或之後的第一個可編輯位置。 若找到，該可編輯位置的值會改為指定的字元。 input 以下任一條件都會導致錯誤狀況，導致不執行替換，且會回傳 值 false ：

• 參數 pos 小於零或大於 Length 格式化字串的參數。

• 在指定位置 pos或之後的格式化字串中，找不到可編輯字元。

• 替換字元 input，因為無法列印或與對應遮罩元素不符，因此不是一個有效的輸入字元。

除了回傳值外，此方法還有兩個輸出參數，以提供關於替換操作的額外資訊。

另請參閱

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

public:
 bool Replace(System::String ^ input, int position);

public bool Replace(string input, int position);

member this.Replace : string * int -> bool

Public Function Replace (input As String, position As Integer) As Boolean

參數

傳回

true如果所有角色都成功替換;否則，。 false

例外狀況

備註

該Replace(String, Int32)方法搜尋位於指定位置或之後的第一個可編輯位置。 pos 假設此點之後仍有足夠可編輯位置，現有字元值會逐一替換為替換字串參數 input的內容。

以下條件被視為錯誤。 當發生錯誤時，不會有替換，並 Replace(String, Int32) 返回 false。

• 參數 pos 小於零或大於 Length 格式化字串的參數。

• 格式化字串中可編輯的位置不足以容納替換字串的內容。

• 其中一個替換字元值不適用，因為它無法列印或與對應的遮罩元素不符。

另請參閱

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

public:
 bool Replace(char input, int position);

public bool Replace(char input, int position);

member this.Replace : char * int -> bool

Public Function Replace (input As Char, position As Integer) As Boolean

參數

傳回

true如果角色被成功替換;否則，。 false

備註

該 Replace(Char, Int32) 方法搜尋格式化字串中，位於指定位置 pos或之後的第一個可編輯位置。 若找到，該可編輯位置的值會改為指定的字元。 input 以下任一條件都會導致錯誤，導致不執行替換，並回傳 的 false 值：

• 參數 pos 小於零或大於 Length 格式化字串的參數。

• 在指定位置 pos或之後的格式化字串中，找不到可編輯字元。

• 替換字元 input，因為無法列印或與對應遮罩元素不符，因此不是一個有效的輸入字元。

另請參閱

• IsValidInputChar(Char)
• FindEditPositionFrom(Int32, Boolean)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set