MaskedTextProvider.Set 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將格式化字串設為指定的輸入字串。
多載
Set(String) |
將格式化字串設為指定的輸入字串。 |
Set(String, Int32, MaskedTextResultHint) |
將格式化字串設為指定的輸入字串,然後輸出移除位置和描述性資訊。 |
Set(String)
將格式化字串設為指定的輸入字串。
public:
bool Set(System::String ^ input);
public bool Set (string input);
member this.Set : string -> bool
Public Function Set (input As String) As Boolean
參數
傳回
如果成功設定所有字元,則為 true
,否則為 false
。
例外狀況
input
參數為 null
。
備註
方法 Set 會清除格式化字串的現有內容,然後將遮罩套用至 input
字元串,以更新格式化字串的內容。
下列條件會被視為錯誤。 發生錯誤時,格式化字串會維持不變並 Set 傳 false
回 。
格式化字串中沒有足夠的可編輯位置,無法儲存取代字串的內容。
其中一個取代字元值無效,因為它無法列印或不符合其對應的mask元素。
另請參閱
適用於
Set(String, Int32, MaskedTextResultHint)
將格式化字串設為指定的輸入字串,然後輸出移除位置和描述性資訊。
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
參數
- testPosition
- Int32
如果成功,則會是格式化字串中實際設定最後一個字元之以零起始的位置,否則,會是作業失敗的第一個位置。 輸出參數。
- resultHint
- MaskedTextResultHint
MaskedTextResultHint,簡潔描述設定作業的結果。 輸出參數。
傳回
如果成功設定所有字元,則為 true
,否則為 false
。
例外狀況
input
參數為 null
。
備註
方法 Set 會清除格式化字串的現有內容,然後將遮罩套用至 input
字元串,以更新格式化字串的內容。
下列條件會被視為錯誤。 發生錯誤時,格式化字串會維持不變並 Set 傳 false
回 。
格式化字串中沒有足夠的可編輯位置,無法儲存取代字串的內容。
其中一個取代字元值無效,因為它無法列印或不符合其對應的mask元素。
這個版本的 Set 提供兩個額外的輸出參數,以傳達方法作業的詳細資訊。