MaskedTextProvider 类

定义

表示一个掩码分析服务,该服务可由支持掩码的任意数量的控件(例如 MaskedTextBox 控件)使用。

public ref class MaskedTextProvider : ICloneable
public class MaskedTextProvider : ICloneable
type MaskedTextProvider = class
    interface ICloneable
Public Class MaskedTextProvider
Implements ICloneable
继承
MaskedTextProvider
实现

注解

MaskedTextBox 控件包含一个掩码,由文本字符和格式元素组成,用于测试所有用户输入。 Windows 窗体将特定掩码分析引擎与 MaskedTextBox永久关联,而是将其作为单独的服务提供,由 MaskedTextProvider 类表示,该类定义 Mask 属性文档中讨论的掩码语言的语法。

MaskedTextBox 类的许多成员都将其实现引用为关联 MaskedTextProvider的类似命名成员。 例如,MaskedTextBox 类的 MaskedTextBox.PromptChar 属性引用 MaskedTextProviderPromptChar 的所有访问权限。

MaskedTextProvider 使用的掩码分析引擎在 visual Basic 版本 6 Microsoft 中包含的屏蔽编辑控件后建模。 其掩码语言在 Mask 属性的文档中介绍。

以下三个不同的字符串与 MaskedTextProvider 类相关。

字符串名称 描述
输入字符或字符串 表示用作应用掩码的输入的字符。 实际上,输入字符串可以由多个输入操作组成,包括 AddReplaceInsertAtRemove。 因此,无法直接访问输入字符串。 但是,输入字符串处理的方面虽然 AllowPromptAsInputAsciiOnlyResetOnPromptResetOnSpace 属性可用。
面具 表示用于将输入字符串转换为格式化字符串的输入格式掩码。 此字符串在 MaskedTextProvider 中设置,主要通过 Mask 属性进行访问。 掩码的特征也可以通过其他成员使用,例如 LengthPasswordCharPromptChar 属性。
带格式的字符串 表示在将完整掩码应用于输入字符串时产生的字符串。 可以使用类的许多成员查询格式化字符串,包括 Item[]LengthLastAssignedPositionMaskFullMaskCompletedFindEditPositionFrom等。 格式化字符串的完整值可从 ToDisplayStringToString 方法获取。

注意

输入字符串可以表示直接用户输入,就像 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

获取或设置一个值,该值指示是否可以用相同的值覆盖掩码中的文本字符位置。

方法

Add(Char, Int32, MaskedTextResultHint)

将指定的输入字符添加到格式化字符串的末尾,然后输出位置和描述性信息。

Add(Char)

将指定的输入字符添加到格式化字符串的末尾。

Add(String, Int32, MaskedTextResultHint)

将指定输入字符串中的字符添加到格式化字符串的末尾,然后输出位置和描述性信息。

Add(String)

将指定输入字符串中的字符添加到格式化字符串的末尾。

Clear()

清除格式化字符串中的所有可编辑输入字符,并将其替换为提示字符。

Clear(MaskedTextResultHint)

清除格式化字符串中的所有可编辑输入字符,将其替换为提示字符,然后输出描述性信息。

Clone()

创建当前 MaskedTextProvider的副本。

Equals(Object)

确定指定的对象是否等于当前对象。

(继承自 Object)
FindAssignedEditPositionFrom(Int32, Boolean)

使用指定的搜索方向返回指定位置后第一个分配的可编辑位置的位置。

FindAssignedEditPositionInRange(Int32, Int32, Boolean)

返回使用指定搜索方向在指定位置之间分配的第一个可编辑位置的位置。

FindEditPositionFrom(Int32, Boolean)

使用指定的搜索方向返回指定位置之后的第一个可编辑位置的位置。

FindEditPositionInRange(Int32, Int32, Boolean)

使用指定的搜索方向返回指定位置之间的第一个可编辑位置的位置。

FindNonEditPositionFrom(Int32, Boolean)

使用指定的搜索方向返回指定位置之后的第一个不可编辑位置的位置。

FindNonEditPositionInRange(Int32, Int32, Boolean)

使用指定的搜索方向返回指定位置之间的第一个不可编辑位置的位置。

FindUnassignedEditPositionFrom(Int32, Boolean)

使用指定的搜索方向返回指定位置后第一个未分配的可编辑位置的位置。

FindUnassignedEditPositionInRange(Int32, Int32, Boolean)

返回使用指定搜索方向在指定位置之间第一个未分配的可编辑位置的位置。

GetHashCode()

用作默认哈希函数。

(继承自 Object)
GetOperationResultFromHint(MaskedTextResultHint)

确定指定的 MaskedTextResultHint 是否表示成功还是失败。

GetType()

获取当前实例的 Type

(继承自 Object)
InsertAt(Char, Int32, Int32, MaskedTextResultHint)

在格式化字符串中的指定位置插入指定字符,返回最后一个插入位置和操作的状态。

InsertAt(Char, Int32)

在格式化字符串中的指定位置插入指定字符。

InsertAt(String, Int32, Int32, MaskedTextResultHint)

在格式化字符串中的指定位置插入指定的字符串,返回最后一个插入位置和操作的状态。

InsertAt(String, Int32)

在格式化字符串中的指定位置插入指定的字符串。

IsAvailablePosition(Int32)

确定指定位置是否可用于赋值。

IsEditPosition(Int32)

确定指定位置是否可编辑。

IsValidInputChar(Char)

确定指定的字符是否为有效的输入字符。

IsValidMaskChar(Char)

确定指定的字符是否为有效的掩码字符。

IsValidPasswordChar(Char)

确定指定的字符是否为有效的密码字符。

MemberwiseClone()

创建当前 Object的浅表副本。

(继承自 Object)
Remove()

从格式化字符串中删除最后分配的字符。

Remove(Int32, MaskedTextResultHint)

从格式化字符串中删除最后分配的字符,然后输出删除位置和描述性信息。

RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)

从格式化字符串中删除指定位置之间的分配字符,然后输出删除位置和描述性信息。

RemoveAt(Int32, Int32)

从格式化字符串中删除指定位置之间的分配字符。

RemoveAt(Int32)

从格式化字符串中删除位于指定位置的已分配字符。

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

用指定的字符值替换指定起始位置和结束位置之间的单个字符,然后输出删除位置和描述性信息。

Replace(Char, Int32, Int32, MaskedTextResultHint)

将位于指定位置或超出指定位置的单个字符替换为指定的字符值,然后输出删除位置和描述性信息。

Replace(Char, Int32)

用指定的字符值替换位于指定位置或超出指定位置的单个字符。

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

用指定的字符串替换指定起始位置和结束位置之间的可编辑字符范围,然后输出删除位置和描述性信息。

Replace(String, Int32, Int32, MaskedTextResultHint)

用指定的字符串替换从指定位置开始的可编辑字符范围,然后输出删除位置和描述性信息。

Replace(String, Int32)

用指定的字符串替换从指定位置开始的可编辑字符范围。

Set(String, Int32, MaskedTextResultHint)

将格式化字符串设置为指定的输入字符串,然后输出删除位置和描述性信息。

Set(String)

将格式化字符串设置为指定的输入字符串。

ToDisplayString()

以可显示的形式返回带格式的字符串。

ToString()

返回包含所有已分配字符值的格式化字符串。

ToString(Boolean, Boolean, Boolean, Int32, Int32)

返回格式化字符串的子字符串,可以选择包括提示符、文本字符和密码字符。

ToString(Boolean, Boolean, Int32, Int32)

返回格式化字符串的子字符串,可以选择包括提示符和文本字符。

ToString(Boolean, Boolean)

返回带格式的字符串,可以选择包括提示符和文本字符。

ToString(Boolean, Int32, Int32)

返回格式化字符串的子字符串,可以选择包括密码字符。

ToString(Boolean)

返回带格式的字符串,可以选择包括密码字符。

ToString(Int32, Int32)

返回格式化字符串的子字符串。

VerifyChar(Char, Int32, MaskedTextResultHint)

测试是否可以在指定位置成功设置指定的字符。

VerifyEscapeChar(Char, Int32)

测试指定字符是否在指定位置进行转义。

VerifyString(String, Int32, MaskedTextResultHint)

测试是否可以成功设置指定的字符串,然后输出位置和描述性信息。

VerifyString(String)

测试是否可以成功设置指定的字符串。

适用于

另请参阅