MaskedTextProvider.InsertAt 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在格式化字串中的特定位置插入字元或字串。
多載
InsertAt(Char, Int32) |
在格式化字串中的指定位置插入指定字元。 |
InsertAt(String, Int32) |
在格式化字串中的指定位置插入指定字串。 |
InsertAt(Char, Int32, Int32, MaskedTextResultHint) |
在格式化字串中的指定位置插入指定字元,並傳回上一個插入位置和作業狀態。 |
InsertAt(String, Int32, Int32, MaskedTextResultHint) |
在格式化字串中的指定位置插入指定字串,並傳回上一個插入位置和作業狀態。 |
InsertAt(Char, Int32)
在格式化字串中的指定位置插入指定字元。
public:
bool InsertAt(char input, int position);
public bool InsertAt (char input, int position);
member this.InsertAt : char * int -> bool
Public Function InsertAt (input As Char, position As Integer) As Boolean
參數
- position
- Int32
格式化字串中要插入字元之以零起始的位置。
傳回
如果插入成功,則為 true
,否則為 false
。
備註
方法 InsertAt 會將字元插入參數所 pos
指定的第一個編輯位置或之後。 這個方法會將插入點之後的所有現有字元移開一個位置,讓插入 input
字元有空間。 如果發生下列其中一個錯誤,則不會執行插入,而且方法會傳 false
回 。
參數
pos
小於零或大於 Length 格式化字串的 。在格式字串中找不到可編輯的字元,位於或超出指定的位置
pos
。插入字元
input
不是有效的輸入字元,因為它無法列印或不符合其對應的mask元素。插入點右邊沒有可用的位置,因此無法移動現有的字元。
移動現有的字元會產生遮罩違規。
空 input
字串不會在格式化字串中造成變更,但會傳回 true
。
另請參閱
適用於
InsertAt(String, Int32)
在格式化字串中的指定位置插入指定字串。
public:
bool InsertAt(System::String ^ input, int position);
public bool InsertAt (string input, int position);
member this.InsertAt : string * int -> bool
Public Function InsertAt (input As String, position As Integer) As Boolean
參數
- position
- Int32
格式化字串中要插入輸入字串之以零起始的位置。
傳回
如果插入成功,則為 true
,否則為 false
。
例外狀況
input
參數為 null
。
備註
方法 InsertAt 會將字串中的每個字元 input
插入位於位置 pos
及更新位置的編輯位置。 這個方法會將插入點之後的所有現有字元移出每個插入字元的一個位置。 如果發生下列其中一個錯誤,則不會執行任何插入,而且方法會傳 false
回 。
參數
pos
小於零或大於 Length 格式化字串的 。格式字串中沒有足夠的可編輯字元存在於指定的位置以上,
pos
以插入字串中的所有字元input
。一或多個插入字元不是有效的輸入字元,因為它們無法列印或不符合其對應的遮罩元素。
插入點右邊沒有足夠的可用位置,因此無法移動現有的字元。
移動現有的字元會產生遮罩違規。 請注意,這會在插入每個個別字元期間發生。
空 input
字串不會在格式化字串中造成變更,但會傳回 true
。
另請參閱
適用於
InsertAt(Char, Int32, Int32, MaskedTextResultHint)
在格式化字串中的指定位置插入指定字元,並傳回上一個插入位置和作業狀態。
public:
bool InsertAt(char input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool InsertAt (char input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.InsertAt : char * int * int * MaskedTextResultHint -> bool
Public Function InsertAt (input As Char, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean
參數
- position
- Int32
格式化字串中要插入字元之以零起始的位置。
- testPosition
- Int32
如果方法成功,則為最後一個插入字元位置,否則為插入失敗的第一個位置。 輸出參數。
- resultHint
- MaskedTextResultHint
MaskedTextResultHint,簡潔描述插入作業的結果。 輸出參數。
傳回
如果插入成功,則為 true
,否則為 false
。
備註
方法 InsertAt 會將字元插入參數所 pos
指定的第一個編輯位置或之後。 這個方法會將插入點之後的所有現有字元移開一個位置,讓插入 input
字元有空間。 如果發生下列其中一個錯誤,則不會執行插入,而且方法會傳 false
回 。
參數
pos
小於零或大於 Length 格式化字串的 。在格式字串中找不到可編輯的字元,位於或超出指定的位置
pos
。插入字元
input
不是有效的輸入字元,因為它無法列印或不符合其對應的mask元素。插入點右邊沒有可用的位置,因此無法移動現有的字元。
移動現有的字元會產生遮罩違規。
空 input
字串不會在格式化字串中造成變更,但會傳回 true
。
另請參閱
適用於
InsertAt(String, Int32, Int32, MaskedTextResultHint)
在格式化字串中的指定位置插入指定字串,並傳回上一個插入位置和作業狀態。
public:
bool InsertAt(System::String ^ input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool InsertAt (string input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.InsertAt : string * int * int * MaskedTextResultHint -> bool
Public Function InsertAt (input As String, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean
參數
- position
- Int32
格式化字串中要插入輸入字串之以零起始的位置。
- testPosition
- Int32
如果方法成功,則為最後一個插入字元位置,否則為插入失敗的第一個位置。 輸出參數。
- resultHint
- MaskedTextResultHint
MaskedTextResultHint,簡潔描述插入作業的結果。 輸出參數。
傳回
如果插入成功,則為 true
,否則為 false
。
例外狀況
input
參數為 null
。
備註
方法 InsertAt 會將字串中的每個字元 input
插入位於位置 pos
及更新位置的編輯位置。 這個方法會將插入點之後的所有現有字元移出每個插入字元的一個位置。 如果發生下列其中一個錯誤,則不會執行任何插入,而且方法會傳 false
回 。
參數
pos
小於零或大於 Length 格式化字串的 。格式字串中沒有足夠的可編輯字元存在於指定的位置以上,
pos
以插入字串中的所有字元input
。一或多個插入字元不是有效的輸入字元,因為它們無法列印或不符合其對應的遮罩元素。
插入點右邊沒有足夠的可用位置,因此無法移動現有的字元。
移動現有的字元會產生遮罩違規。 請注意,這會在插入每個個別字元期間發生。
空 input
字串不會在格式化字串中造成變更,但會傳回 true
。