MaskedTextProvider.Add 方法

定义

将输入字符或输入字符串添加到带格式字符串中。

重载

Add(String, Int32, MaskedTextResultHint)

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

Add(Char, Int32, MaskedTextResultHint)

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

Add(Char)

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

Add(String)

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

Add(String, Int32, MaskedTextResultHint)

Source:
MaskedTextProvider.cs
Source:
MaskedTextProvider.cs
Source:
MaskedTextProvider.cs

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

public:
 bool Add(System::String ^ input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Add (string input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Add : string * int * MaskedTextResultHint -> bool
Public Function Add (input As String, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

参数

input
String

一个 String,包含要追加到带格式字符串的字符值。

testPosition
Int32

带格式的字符串中尝试添加字符的位置(从零开始计)。 一个输出参数。

resultHint
MaskedTextResultHint

一个 MaskedTextResultHint,用于简单地描述操作的结果。 一个输出参数。

返回

如果已成功添加输入字符串中的所有字符,则为 true;否则为 false,以指示没有添加任何字符。

注解

方法 Add(String, Int32, MaskedTextResultHint) 将字符串中的字符 input 添加到格式化字符串,从 之后 LastAssignedPosition的第一个可用位置开始。 此方法将因以下任一原因而失败:

  • 输入值 input中的任何字符都是不可打印的,或者输入值与其对应的掩码元素不匹配。

  • 在上次分配的位置之后,格式化字符串中没有足够的可用编辑位置。

如果此方法失败,则不添加任何内容,并且该方法返回 false

此方法的功能与采用单个 String 参数 的重写版本相同, Add(String)只不过它输出其他信息。

另请参阅

适用于

Add(Char, Int32, MaskedTextResultHint)

Source:
MaskedTextProvider.cs
Source:
MaskedTextProvider.cs
Source:
MaskedTextProvider.cs

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

public:
 bool Add(char input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Add (char input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Add : char * int * MaskedTextResultHint -> bool
Public Function Add (input As Char, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

参数

input
Char

一个要追加到带格式字符串的 Char 值。

testPosition
Int32

带格式的字符串中尝试添加字符的位置(从零开始计)。 一个输出参数。

resultHint
MaskedTextResultHint

一个 MaskedTextResultHint,用于简单地描述操作的结果。 一个输出参数。

返回

如果输入字符添加成功,则为 true;否则为 false

注解

方法 Add(Char, Int32, MaskedTextResultHint) 尝试将 input 字符值添加到格式化字符串中最后分配的位置之后的第一个可用位置,该位置由 LastAssignedPosition 属性表示。 如果所有可用位置都早于上次分配的位置,则此方法将失败。 此方法将因以下任一原因而失败:

  • 输入值 input是不可打印的,或者它与对应的掩码元素不匹配。

  • 格式化字符串中没有可用的编辑位置,或者在最后一个分配的位置之后没有可用的编辑位置。

此方法的功能与采用单个 Char 参数 的重写版本相同, Add(Char)只不过它输出其他信息。

另请参阅

适用于

Add(Char)

Source:
MaskedTextProvider.cs
Source:
MaskedTextProvider.cs
Source:
MaskedTextProvider.cs

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

public:
 bool Add(char input);
public bool Add (char input);
member this.Add : char -> bool
Public Function Add (input As Char) As Boolean

参数

input
Char

一个要追加到带格式字符串的 Char 值。

返回

如果输入字符添加成功,则为 true;否则为 false

注解

方法 Add(Char)input 字符值添加到格式化字符串中最后分配的位置之后的第一个可用位置,该位置由 LastAssignedPosition 属性表示。 此方法将因以下任一原因而失败:

  • 输入值 input是不可打印的,或者它与对应的掩码元素不匹配。

  • 格式化字符串中没有可用的编辑位置,或者在最后一个分配的位置之后没有可用的编辑位置。

另请参阅

适用于

Add(String)

Source:
MaskedTextProvider.cs
Source:
MaskedTextProvider.cs
Source:
MaskedTextProvider.cs

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

public:
 bool Add(System::String ^ input);
public bool Add (string input);
member this.Add : string -> bool
Public Function Add (input As String) As Boolean

参数

input
String

一个 String,包含要追加到带格式字符串的字符值。

返回

如果已成功添加输入字符串中的所有字符,则为 true;否则为 false,以指示没有添加任何字符。

例外

input 参数为 null

注解

方法 Add(String) 将字符串中的字符 input 添加到格式化字符串,从 之后 LastAssignedPosition的第一个可用位置开始。 此方法将因以下任一原因而失败:

  • 输入值 input中的任何字符都是不可打印的,或者输入值与其对应的掩码元素不匹配。

  • 在上次分配的位置之后,格式化字符串中没有足够的可用编辑位置。

如果此方法失败,则不添加任何内容,并且该方法返回 false

另请参阅

适用于