MaskedTextProvider.Add 方法

定義

命名空間:

System.ComponentModel

組件:

netstandard.dll, System.ComponentModel.TypeConverter.dll

在格式化字串中加入輸入字元或輸入字串。

多載

名稱	Description
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 A，簡潔地描述了手術的結果。 輸出參數。

傳回

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 A，簡潔地描述了手術的結果。 輸出參數。

傳回

Boolean

true 如果輸入字元成功加入;否則 false。

備註

此 Add(Char, Int32, MaskedTextResultHint) 方法嘗試將字元值加入 input 格式化字串中，在最後指派位置後的第一個可用位置，該位置由屬性表示 LastAssignedPosition 。 若所有可用位置都早於最後分配的位置，此方法將失敗。 此方法將因以下任一原因失敗：

• 輸入值 input， 不可列印，或與對應的遮罩元素不符。

• 格式化字串中沒有可用的編輯位置，或是在最後分配位置之後沒有可用的編輯位置。

此方法的運作方式與覆蓋版本相同，採用單一 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， 不可列印，或與對應的遮罩元素不符。

• 格式化字串中沒有可用的編輯位置，或是在最後分配位置之後沒有可用的編輯位置。

另請參閱

• 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