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.PromptChar 类的 MaskedTextBox 属性引用对 PromptChar 类的所有 MaskedTextProvider 访问。

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

类涉及 MaskedTextProvider 以下三个不同的字符串。

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

注意

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

获取或设置一个值,该值指示掩码中的原义字符位置是否可由其相同的值覆盖。

方法

Add(Char)

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

Add(Char, Int32, MaskedTextResultHint)

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

Add(String)

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

Add(String, Int32, MaskedTextResultHint)

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

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)

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

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

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

InsertAt(String, Int32)

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

InsertAt(String, Int32, Int32, MaskedTextResultHint)

将指定的字符串插入到带格式字符串中的指定位置,同时返回最后一个插入位置和操作的状态。

IsAvailablePosition(Int32)

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

IsEditPosition(Int32)

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

IsValidInputChar(Char)

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

IsValidMaskChar(Char)

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

IsValidPasswordChar(Char)

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

MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
Remove()

从带格式的字符串中移除最后一个赋值的字符。

Remove(Int32, MaskedTextResultHint)

从带格式字符串中移除最后一个赋值的字符,然后输出移除位置和描述性信息。

RemoveAt(Int32)

从带格式的字符串中移除位于指定位置的赋值字符。

RemoveAt(Int32, Int32)

从带格式的字符串中移除指定位置之间的赋值的字符。

RemoveAt(Int32, Int32, Int32, MaskedTextResultHint)

从带格式的字符串中移除指定位置之间的赋值的字符,然后输出移除位置和描述性信息。

Replace(Char, Int32)

用指定的字符值替换指定位置或指定位置后面的单个字符。

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

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

Replace(Char, Int32, Int32, MaskedTextResultHint)

用指定的字符值替换指定位置或指定位置后面的单个字符,然后输出移除位置和描述性信息。

Replace(String, Int32)

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

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

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

Replace(String, Int32, Int32, MaskedTextResultHint)

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

Set(String)

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

Set(String, Int32, MaskedTextResultHint)

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

ToDisplayString()

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

ToString()

返回包含所有赋值的字符值的带格式字符串。

ToString(Boolean)

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

ToString(Boolean, Boolean)

返回带格式的字符串,还可以选择包含提示字符和原义字符。

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

返回带格式字符串的子字符串,可以选择包含提示字符、原义字符和密码字符。

ToString(Boolean, Boolean, Int32, Int32)

返回带格式字符串的子字符串,也可以选择包含提示字符和原义字符。

ToString(Boolean, Int32, Int32)

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

ToString(Int32, Int32)

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

VerifyChar(Char, Int32, MaskedTextResultHint)

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

VerifyEscapeChar(Char, Int32)

测试指定的字符是否将在指定位置转义。

VerifyString(String)

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

VerifyString(String, Int32, MaskedTextResultHint)

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

适用于

另请参阅