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.PromptChar 类的 MaskedTextBox 属性引用对 PromptChar 类的所有 MaskedTextProvider 访问。
使用的 MaskedTextProvider 掩码分析引擎在 Microsoft Visual Basic 版本 6 中包含的掩码编辑控件之后建模。 其掩码语言在 属性的文档 Mask 中介绍。
类涉及 MaskedTextProvider 以下三个不同的字符串。
| 字符串名称 | 说明 |
|---|---|
| 输入字符或字符串 | 表示用作应用掩码的输入的字符。 实际上，输入字符串可能由多个输入操作组成，包括 Add、 Replace、 InsertAt和 Remove。 因此，无法直接访问输入字符串。 但是，输入字符串处理的各个方面可通过 AllowPromptAsInput 和 AsciiOnly、 ResetOnPrompt和 ResetOnSpace 属性使用。 |
| Mask | 表示用于将输入字符串转换为格式化字符串的输入格式掩码。 此字符串在 中 MaskedTextProvider 设置，主要通过 Mask 属性进行访问。 掩码的特征也通过其他成员（如 Length、 PasswordChar和 PromptChar 属性）提供。 |
| 带格式的字符串 | 表示在将完整掩码应用于输入字符串时产生的字符串。 可以使用类的许多成员（包括 Item[]、、Length、 MaskCompletedLastAssignedPositionMaskFullFindEditPositionFrom等）查询格式化字符串。 格式化字符串的完整值可从 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 |
获取或设置一个值，该值指示掩码中的原义字符位置是否可由其相同的值覆盖。 |
