MaskedTextProvider 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示遮罩剖析服務，任何支援遮罩的控制項數目都可以使用它，例如 MaskedTextBox 控制項。
public ref class MaskedTextProvider : ICloneablepublic class MaskedTextProvider : ICloneabletype MaskedTextProvider = class
interface ICloneablePublic Class MaskedTextProvider
Implements ICloneable- 繼承
-
MaskedTextProvider
- 實作
備註
控件 MaskedTextBox 包含一個遮罩，由常值字元和格式化元素所組成，它會測試所有用戶輸入。 Windows Forms 會以 類別表示MaskedTextProvider，而不是永久將特定遮罩剖析引擎與 MaskedTextBox建立關聯，這會定義 屬性檔中Mask所討論遮罩語言的語法。
類別的許多成員都參考其實作 MaskedTextBox ，類似於相關聯 MaskedTextProvider之的具名成員。 例如，類別MaskedTextBox.PromptChar的 MaskedTextBox 屬性是指類別的所有MaskedTextProvider存取PromptChar權。
所使用的 MaskedTextProvider 遮罩剖析引擎會模型化為 Microsoft Visual Basic 第 6 版中包含的遮罩編輯控制元件。 其遮罩語言描述於 屬性的檔 Mask 中。
下列三個不同的字串與類別相關 MaskedTextProvider 。
| 名稱字串 | 描述 |
|---|---|
| 輸入字元或字串 | 表示用來做為遮罩所套用輸入的字元。 實際上，輸入字串可能是由多個輸入作業所組成，包括 Add、 Replace、 InsertAt和 Remove。 因此，無法直接存取輸入字串。 不過，輸入字串處理的各個層面可透過 AllowPromptAsInput 和 AsciiOnly、 ResetOnPrompt和 ResetOnSpace 屬性取得。 |
| Mask | 表示用來將輸入字串轉換成格式化字串的輸入格式遮罩。 這個字串是在 中 MaskedTextProvider 設定，主要是透過 Mask 屬性來存取。 遮罩的特性也可以透過其他成員取得，例如 Length、 PasswordChar和 PromptChar 屬性。 |
| 格式化字串 | 表示當完整遮罩套用至輸入字串時所產生的字串。 您可以使用 類別的許多成員查詢格式化字串，包括Item[]、Length、LastAssignedPosition、、MaskFull、 MaskCompletedFindEditPositionFrom等等。 格式化字串的完整值可從 ToDisplayString 和 ToString 方法取得。 |
注意
輸入字串可能會表示直接使用者輸入，如 的情況 MaskedTextBox，或可能由未直接與使用者輸入/輸出作業相關聯的其他進程產生。
建構函式
| MaskedTextProvider(String) |
使用指定的遮罩，初始化 MaskedTextProvider 類別的新執行個體。 |
| MaskedTextProvider(String, Boolean) |
使用指定的遮罩和 ASCII 限制值，初始化 MaskedTextProvider 類別的新執行個體。 |
| MaskedTextProvider(String, Char, Boolean) |
使用指定的遮罩、密碼字元和提示使用值，初始化 MaskedTextProvider 類別的新執行個體。 |
| MaskedTextProvider(String, CultureInfo) |
使用指定的遮罩和文化特性，初始化 MaskedTextProvider 類別的新執行個體。 |
| MaskedTextProvider(String, CultureInfo, Boolean) |
使用指定的遮罩、文化特性和 ASCII 限制值，初始化 MaskedTextProvider 類別的新執行個體。 |
| MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean) |
使用指定的遮罩、文化特性、提示使用值、提示字元、密碼字元和 ASCII 限制值，初始化 MaskedTextProvider 類別的新執行個體。 |
| MaskedTextProvider(String, CultureInfo, Char, Boolean) |
使用指定的遮罩、文化特性、密碼字元和提示使用值，初始化 MaskedTextProvider 類別的新執行個體。 |
屬性
| AllowPromptAsInput |
取得值，指出提示字元是否應視為有效輸入字元。 |
| AsciiOnly |
取得值，指出遮罩是否接受 ASCII 字元集之外的字元。 |
| AssignedEditPositionCount |
取得已成功指派輸入值之可編輯的字元位置數目。 |
| AvailableEditPositionCount |
取得輸入遮罩中尚未指派輸入值的可編輯字元位置數目。 |
| Culture |
取得文化特性，以便判斷輸入遮罩中可當地語系化分隔符號和替代符號的值。 |
| DefaultPasswordChar |
取得用來遮蔽使用者輸入的預設密碼字元。 |
| EditPositionCount |
取得格式化字串中可編輯的位置數目。 |
| EditPositions |
取得格式化字串中可編輯位置的新建立列舉值。 |
| IncludeLiterals |
取得或設定值，指出輸入遮罩中的常值字元是否應該包含在格式化字串中。 |
| IncludePrompt |
取得或設定值，指出 PromptChar 是否用來表示，在顯示格式化字串時使用者輸入項目不存在。 |
| InvalidIndex |
取得無效索引範圍的上限。 |
| IsPassword |
取得或設定值，判斷密碼保護是否應套用至格式化字串。 |
| Item[Int32] |
取得格式化字串中位於指定位置的項目。 |
| LastAssignedPosition |
取得遮罩中最右側指定輸入字元的索引。 |
| Length |
取得遮罩長度，不計任何遮罩修飾詞字元。 |
| Mask |
取得輸入遮罩。 |
| MaskCompleted |
取得值，指出所有必要的輸入項目是否已輸入格式化字串。 |
| MaskFull |
取得值，指出所有必要和選擇性的輸入項目是否已輸入格式化字串。 |
| PasswordChar |
取得或設定字元，取代實際輸入字元。 |
| PromptChar |
取得或設定字元，用來表示所有可用編輯位置的使用者輸入項目不存在。 |
| ResetOnPrompt |
取得或設定值，判斷應如何處理符合提示字元的輸入字元。 |
| ResetOnSpace |
取得或設定值，判斷應如何處理空格輸入字元。 |
| SkipLiterals |
取得或設定值，指出遮罩中的常值字元位置是否可以用其相同值覆寫。 |
