MaskedTextProvider.Add 方法

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

將輸入字元或輸入字串加入至格式化字串。

多載

Add(String, Int32, MaskedTextResultHint)	將指定輸入字串的字元加入至格式化字串的結尾，然後輸出位置和描述性資訊。
Add(Char, Int32, MaskedTextResultHint)	將指定的輸入字元加入至格式化字串的結尾，然後輸出位置和描述性資訊。
Add(Char)	將指定的輸入字元加入至格式化字串的結尾。
Add(String)	將指定輸入字串的字元加入至格式化字串的結尾。

Add(String, Int32, MaskedTextResultHint)

來源:

MaskedTextProvider.cs

將指定輸入字串的字元加入至格式化字串的結尾，然後輸出位置和描述性資訊。

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

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

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

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

參數

input

String

String，包含要附加至格式化字串的字元值。

testPosition

Int32

格式化字串中以零起始的位置，在這個位置上嘗試加入字元。 輸出參數。

resultHint

MaskedTextResultHint

MaskedTextResultHint，簡潔描述運算的結果。 輸出參數。

傳回

Boolean

true 表示輸入字串的所有字元已成功加入，而 false 則表示未加入任何字元。

備註

方法 Add(String, Int32, MaskedTextResultHint) 會將字串中的 input 字元加入格式化字串，從 之後的第一個可用位置 LastAssignedPosition開始。 此方法會因為下列任何原因而失敗：

• 輸入值 、 input、 中的任何字元都無法列印，或輸入值不符合其對應的遮罩元素。

• 在最後一個指派的位置之後，格式化字串中沒有足夠的可用編輯位置。

如果這個方法失敗，則不會新增任何專案，而且方法會傳 false回 。

這個方法的運作方式與採用單 String 一參數的覆寫版本相同， Add(String)不同之處在於它會輸出其他資訊。

另請參閱

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString

Add(Char, Int32, MaskedTextResultHint)

來源:

MaskedTextProvider.cs

將指定的輸入字元加入至格式化字串的結尾，然後輸出位置和描述性資訊。

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

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

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

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

參數

input

Char

Char 值，要附加至格式化字串。

testPosition

Int32

格式化字串中以零起始的位置，在這個位置上嘗試加入字元。 輸出參數。

resultHint

MaskedTextResultHint

MaskedTextResultHint，簡潔描述運算的結果。 輸出參數。

傳回

Boolean

如果輸入字元已成功加入，則為 true，否則為 false。

備註

方法 Add(Char, Int32, MaskedTextResultHint) 會嘗試在上次指派的位置之後，將字元值新增 input 至格式化字串中的第一個可用位置，由 屬性表示 LastAssignedPosition 。 如果所有可用位置都位於最後一個指派的位置之前，這個方法將會失敗。 此方法會因為下列任何原因而失敗：

• 輸入值 input、 無法列印，或不符合其對應的mask元素。

• 格式化字串中有零個可用的編輯位置，或在最後一個指派的位置之後沒有可用的編輯位置。

這個方法的運作方式與採用單 Char 一參數的覆寫版本相同， Add(Char)不同之處在於它會輸出其他資訊。

另請參閱

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(Char)

來源:

MaskedTextProvider.cs

將指定的輸入字元加入至格式化字串的結尾。

public:
 bool Add(char input);

public bool Add (char input);

member this.Add : char -> bool

Public Function Add (input As Char) As Boolean

參數

input

Char

Char 值，要附加至格式化字串。

傳回

Boolean

如果輸入字元已成功加入，則為 true，否則為 false。

備註

方法會將Add(Char)input字元值新增至格式化字串中的第一個可用位置，該位置在上次指派的位置之後，由 屬性表示LastAssignedPosition。 此方法會因為下列任何原因而失敗：

• 輸入值 input、 無法列印，或不符合其對應的mask元素。

• 格式化字串中有零個可用的編輯位置，或在最後一個指派的位置之後沒有可用的編輯位置。

另請參閱

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(String)

來源:

MaskedTextProvider.cs

將指定輸入字串的字元加入至格式化字串的結尾。

public:
 bool Add(System::String ^ input);

public bool Add (string input);

member this.Add : string -> bool

Public Function Add (input As String) As Boolean

參數

input

String

String，包含要附加至格式化字串的字元值。

傳回

Boolean

true 表示輸入字串的所有字元已成功加入，而 false 則表示未加入任何字元。

例外狀況

ArgumentNullException

input 參數為 null。

備註

方法 Add(String) 會將字串中的 input 字元加入格式化字串，從 之後的第一個可用位置 LastAssignedPosition開始。 此方法會因為下列任何原因而失敗：

• 輸入值 、 input、 中的任何字元都無法列印，或輸入值不符合其對應的遮罩元素。

• 在最後一個指派的位置之後，格式化字串中沒有足夠的可用編輯位置。

如果這個方法失敗，則不會新增任何專案，而且方法會傳 false回 。

另請參閱

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString