MaskedTextProvider.Set 方法

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.TypeConverter.dll

將格式化字串設為指定的輸入字串。

多載

Set(String)	將格式化字串設為指定的輸入字串。
Set(String, Int32, MaskedTextResultHint)	將格式化字串設為指定的輸入字串，然後輸出移除位置和描述性資訊。

Set(String)

來源:

MaskedTextProvider.cs

將格式化字串設為指定的輸入字串。

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

public bool Set (string input);

member this.Set : string -> bool

Public Function Set (input As String) As Boolean

參數

input

String

用來設定格式化字串的 String 值。

傳回

Boolean

如果成功設定所有字元，則為 true，否則為 false。

例外狀況

ArgumentNullException

input 參數為 null。

備註

方法 Set 會清除格式化字串的現有內容，然後將遮罩套用至 input 字元串，以更新格式化字串的內容。

下列條件會被視為錯誤。 發生錯誤時，格式化字串會維持不變並 Set 傳 false回 。

• 格式化字串中沒有足夠的可編輯位置，無法儲存取代字串的內容。

• 其中一個取代字元值無效，因為它無法列印或不符合其對應的mask元素。

另請參閱

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

Set(String, Int32, MaskedTextResultHint)

來源:

MaskedTextProvider.cs

將格式化字串設為指定的輸入字串，然後輸出移除位置和描述性資訊。

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

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

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

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

參數

input

String

用來設定格式化字串的 String 值。

testPosition

Int32

如果成功，則會是格式化字串中實際設定最後一個字元之以零起始的位置，否則，會是作業失敗的第一個位置。 輸出參數。

resultHint

MaskedTextResultHint

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

傳回

Boolean

如果成功設定所有字元，則為 true，否則為 false。

例外狀況

ArgumentNullException

input 參數為 null。

備註

方法 Set 會清除格式化字串的現有內容，然後將遮罩套用至 input 字元串，以更新格式化字串的內容。

下列條件會被視為錯誤。 發生錯誤時，格式化字串會維持不變並 Set 傳 false回 。

• 格式化字串中沒有足夠的可編輯位置，無法儲存取代字串的內容。

• 其中一個取代字元值無效，因為它無法列印或不符合其對應的mask元素。

這個版本的 Set 提供兩個額外的輸出參數，以傳達方法作業的詳細資訊。

另請參閱

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