MaskedTextProvider 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示一个掩码分析服务，该服务可由支持掩码的任意数量的控件（例如 MaskedTextBox 控件）使用。
public ref class MaskedTextProvider : ICloneablepublic class MaskedTextProvider : ICloneabletype MaskedTextProvider = class
interface ICloneablePublic Class MaskedTextProvider
Implements ICloneable- 继承
-
MaskedTextProvider
- 实现
注解
MaskedTextBox 控件包含一个掩码，由文本字符和格式元素组成，用于测试所有用户输入。 Windows 窗体将特定掩码分析引擎与 MaskedTextBox永久关联，而是将其作为单独的服务提供，由 MaskedTextProvider 类表示，该类定义 Mask 属性文档中讨论的掩码语言的语法。
MaskedTextBox 类的许多成员都将其实现引用为关联 MaskedTextProvider的类似命名成员。 例如，MaskedTextBox 类的 MaskedTextBox.PromptChar 属性引用 MaskedTextProvider 类 PromptChar 的所有访问权限。
MaskedTextProvider 使用的掩码分析引擎在 visual Basic 版本 6 Microsoft 中包含的屏蔽编辑控件后建模。 其掩码语言在 Mask 属性的文档中介绍。
以下三个不同的字符串与 MaskedTextProvider 类相关。
| 字符串名称 | 描述 |
|---|---|
| 输入字符或字符串 | 表示用作应用掩码的输入的字符。 实际上，输入字符串可以由多个输入操作组成，包括 Add、Replace、InsertAt和 Remove。 因此，无法直接访问输入字符串。 但是，输入字符串处理的方面虽然 AllowPromptAsInput 和 AsciiOnly、ResetOnPrompt和 ResetOnSpace 属性可用。 |
| 面具 | 表示用于将输入字符串转换为格式化字符串的输入格式掩码。 此字符串在 MaskedTextProvider 中设置，主要通过 Mask 属性进行访问。 掩码的特征也可以通过其他成员使用，例如 Length、PasswordChar和 PromptChar 属性。 |
| 带格式的字符串 | 表示在将完整掩码应用于输入字符串时产生的字符串。 可以使用类的许多成员查询格式化字符串，包括 Item[]、Length、LastAssignedPosition、MaskFull、MaskCompleted、FindEditPositionFrom等。 格式化字符串的完整值可从 ToDisplayString 和 ToString 方法获取。 |
注意
输入字符串可以表示直接用户输入，就像 MaskedTextBox一样，也可以由不直接与用户输入/输出操作关联的其他进程生成。
构造函数
| MaskedTextProvider(String, Boolean) |
使用指定的掩码和 ASCII 限制值初始化 MaskedTextProvider 类的新实例。 |
| MaskedTextProvider(String, Char, Boolean) |
使用指定的掩码、密码字符和提示使用值初始化 MaskedTextProvider 类的新实例。 |
| MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean) |
使用指定的掩码、区域性、提示使用值、提示字符、密码字符和 ASCII 限制值初始化 MaskedTextProvider 类的新实例。 |
| MaskedTextProvider(String, CultureInfo, Boolean) |
使用指定的掩码、区域性和 ASCII 限制值初始化 MaskedTextProvider 类的新实例。 |
| MaskedTextProvider(String, CultureInfo, Char, Boolean) |
使用指定的掩码、区域性、密码字符和提示使用值初始化 MaskedTextProvider 类的新实例。 |
| MaskedTextProvider(String, CultureInfo) |
使用指定的掩码和区域性初始化 MaskedTextProvider 类的新实例。 |
| MaskedTextProvider(String) |
使用指定的掩码初始化 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 |
获取或设置一个值，该值指示是否可以用相同的值覆盖掩码中的文本字符位置。 |
