MaskedTextProvider.Set 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將格式化字串設為指定的輸入字串。
| Set(String) |
將格式化字串設為指定的輸入字串。 |
| Set(String, Int32, MaskedTextResultHint) |
將格式化字串設為指定的輸入字串，然後輸出移除位置和描述性資訊。 |
將格式化字串設為指定的輸入字串。
public:
bool Set(System::String ^ input);public bool Set (string input);member this.Set : string -> boolPublic Function Set (input As String) As Boolean參數
傳回
如果成功設定所有字元，則為 true，否則為 false。
例外狀況
input 參數為 null。
備註
方法 Set 會清除格式化字串的現有內容，然後將遮罩套用至 input 字元串，以更新格式化字串的內容。
下列條件會被視為錯誤。 發生錯誤時，格式化字串會維持不變並 Set 傳 false回 。
格式化字串中沒有足夠的可編輯位置，無法儲存取代字串的內容。
其中一個取代字元值無效，因為它無法列印或不符合其對應的mask元素。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
將格式化字串設為指定的輸入字串，然後輸出移除位置和描述性資訊。
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 -> boolPublic 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 提供兩個額外的輸出參數，以傳達方法作業的詳細資訊。
另請參閱
適用於
.NET 9 和其他版本
| 產品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
