MaskedTextProvider.InsertAt 方法

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

在格式化字串中的特定位置插入字元或字串。

多載

InsertAt(Char, Int32)	在格式化字串中的指定位置插入指定字元。
InsertAt(String, Int32)	在格式化字串中的指定位置插入指定字串。
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	在格式化字串中的指定位置插入指定字元，並傳回上一個插入位置和作業狀態。
InsertAt(String, Int32, Int32, MaskedTextResultHint)	在格式化字串中的指定位置插入指定字串，並傳回上一個插入位置和作業狀態。

InsertAt(Char, Int32)

來源:

MaskedTextProvider.cs

在格式化字串中的指定位置插入指定字元。

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

參數

input

Char

要插入的 Char。

position

Int32

格式化字串中要插入字元之以零起始的位置。

傳回

Boolean

如果插入成功，則為 true，否則為 false。

備註

方法 InsertAt 會將字元插入參數所 pos 指定的第一個編輯位置或之後。 這個方法會將插入點之後的所有現有字元移開一個位置，讓插入 input 字元有空間。 如果發生下列其中一個錯誤，則不會執行插入，而且方法會傳 false回 。

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

• 在格式字串中找不到可編輯的字元，位於或超出指定的位置 pos。

• 插入字元 input不是有效的輸入字元，因為它無法列印或不符合其對應的mask元素。

• 插入點右邊沒有可用的位置，因此無法移動現有的字元。

• 移動現有的字元會產生遮罩違規。

空 input 字串不會在格式化字串中造成變更，但會傳回 true。

另請參閱

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32)

來源:

MaskedTextProvider.cs

在格式化字串中的指定位置插入指定字串。

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

參數

input

String

要插入的 String。

position

Int32

格式化字串中要插入輸入字串之以零起始的位置。

傳回

Boolean

如果插入成功，則為 true，否則為 false。

例外狀況

ArgumentNullException

input 參數為 null。

備註

方法 InsertAt 會將字串中的每個字元 input 插入位於位置 pos 及更新位置的編輯位置。 這個方法會將插入點之後的所有現有字元移出每個插入字元的一個位置。 如果發生下列其中一個錯誤，則不會執行任何插入，而且方法會傳 false回 。

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

• 格式字串中沒有足夠的可編輯字元存在於指定的位置以上， pos以插入字串中的所有字元 input 。

• 一或多個插入字元不是有效的輸入字元，因為它們無法列印或不符合其對應的遮罩元素。

• 插入點右邊沒有足夠的可用位置，因此無法移動現有的字元。

• 移動現有的字元會產生遮罩違規。 請注意，這會在插入每個個別字元期間發生。

空 input 字串不會在格式化字串中造成變更，但會傳回 true。

另請參閱

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

來源:

MaskedTextProvider.cs

在格式化字串中的指定位置插入指定字元，並傳回上一個插入位置和作業狀態。

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

參數

input

Char

要插入的 Char。

position

Int32

格式化字串中要插入字元之以零起始的位置。

testPosition

Int32

如果方法成功，則為最後一個插入字元位置，否則為插入失敗的第一個位置。 輸出參數。

resultHint

MaskedTextResultHint

MaskedTextResultHint，簡潔描述插入作業的結果。 輸出參數。

傳回

Boolean

如果插入成功，則為 true，否則為 false。

備註

方法 InsertAt 會將字元插入參數所 pos 指定的第一個編輯位置或之後。 這個方法會將插入點之後的所有現有字元移開一個位置，讓插入 input 字元有空間。 如果發生下列其中一個錯誤，則不會執行插入，而且方法會傳 false回 。

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

• 在格式字串中找不到可編輯的字元，位於或超出指定的位置 pos。

• 插入字元 input不是有效的輸入字元，因為它無法列印或不符合其對應的mask元素。

• 插入點右邊沒有可用的位置，因此無法移動現有的字元。

• 移動現有的字元會產生遮罩違規。

空 input 字串不會在格式化字串中造成變更，但會傳回 true。

另請參閱

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32, Int32, MaskedTextResultHint)

來源:

MaskedTextProvider.cs

在格式化字串中的指定位置插入指定字串，並傳回上一個插入位置和作業狀態。

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

參數

input

String

要插入的 String。

position

Int32

格式化字串中要插入輸入字串之以零起始的位置。

testPosition

Int32

如果方法成功，則為最後一個插入字元位置，否則為插入失敗的第一個位置。 輸出參數。

resultHint

MaskedTextResultHint

MaskedTextResultHint，簡潔描述插入作業的結果。 輸出參數。

傳回

Boolean

如果插入成功，則為 true，否則為 false。

例外狀況

ArgumentNullException

input 參數為 null。

備註

方法 InsertAt 會將字串中的每個字元 input 插入位於位置 pos 及更新位置的編輯位置。 這個方法會將插入點之後的所有現有字元移出每個插入字元的一個位置。 如果發生下列其中一個錯誤，則不會執行任何插入，而且方法會傳 false回 。

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

• 格式字串中沒有足夠的可編輯字元存在於指定的位置以上， pos以插入字串中的所有字元 input 。

• 一或多個插入字元不是有效的輸入字元，因為它們無法列印或不符合其對應的遮罩元素。

• 插入點右邊沒有足夠的可用位置，因此無法移動現有的字元。

• 移動現有的字元會產生遮罩違規。 請注意，這會在插入每個個別字元期間發生。

空 input 字串不會在格式化字串中造成變更，但會傳回 true。

另請參閱

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString