MaskedTextProvider.InsertAt 方法

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.TypeConverter.dll

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

重载

InsertAt(Char, Int32)	在带格式字符串中的指定位置插入指定字符。
InsertAt(String, Int32)	在带格式字符串中的指定位置插入指定的字符串。
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	在带格式字符串中的指定位置插入指定的字符，同时返回最后一个插入位置和操作的状态。
InsertAt(String, Int32, Int32, MaskedTextResultHint)	将指定的字符串插入到带格式字符串中的指定位置，同时返回最后一个插入位置和操作的状态。

InsertAt(Char, Int32)

Source:

MaskedTextProvider.cs

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

public:
 bool InsertAt(char input, int position);

public bool InsertAt (char input, int position);

member this.InsertAt : char * int -> bool

Public Function InsertAt (input As Char, position As Integer) As Boolean

参数

input

Char

要插入的 Char。

position

Int32

带格式的字符串中要插入字符的位置（从零开始计）。

返回

Boolean

如果插入成功，则为 true；否则为 false。

注解

方法 InsertAt 将字符插入到参数指定的第一个编辑位置或超过 该 pos 位置。 此方法会将插入点之后的所有现有字符移一个位置，为插入 input 的字符腾出空间。 如果发生以下错误之一，则不执行插入，并且该方法返回 false。

• 参数 pos 小于零或大于 Length 格式化字符串的 。

• 在指定位置 处或超出指定位置 pos的带格式字符串中找不到可编辑字符。

• 插入字符 input不是有效的输入字符，因为它不可打印或与其对应的 mask 元素不匹配。

• 插入点右侧没有可用位置，因此无法移动现有字符。

• 移动现有字符将导致与掩码冲突。

空 input 字符串不会导致格式化字符串发生更改，但将返回 true。

另请参阅

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32)

Source:

MaskedTextProvider.cs

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

public:
 bool InsertAt(System::String ^ input, int position);

public bool InsertAt (string input, int position);

member this.InsertAt : string * int -> bool

Public Function InsertAt (input As String, position As Integer) As Boolean

参数

input

String

要插入的 String。

position

Int32

带格式的字符串中要插入输入字符串的位置（从零开始计）。

返回

Boolean

如果插入成功，则为 true；否则为 false。

例外

ArgumentNullException

input 参数为 null。

注解

方法 InsertAt 将字符串中的每个 input 字符插入到位于位置及更高位置的编辑位置 pos 。 对于每个插入的字符，此方法会将插入点之后的所有现有字符移位一个位置。 如果发生以下错误之一，则不执行插入，并且该方法返回 false。

• 参数 pos 小于零或大于 Length 格式化字符串的 。

• 在指定位置 处或超出指定位置 pos的带格式字符串中存在足够的可编辑字符，无法插入字符串中的所有 input 字符。

• 一个或多个插入字符不是有效的输入字符，因为它们不可打印或与相应的掩码元素不匹配。

• 插入点右侧的可用位置不足，因此无法移动现有字符。

• 移动现有字符将导致与掩码冲突。 请注意，这种移动发生在插入每个单独的字符期间。

空 input 字符串不会导致格式化字符串发生更改，但将返回 true。

另请参阅

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

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

public:
 bool InsertAt(char input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool InsertAt (char input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.InsertAt : char * int * int * MaskedTextResultHint -> bool

Public Function InsertAt (input As Char, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

参数

input

Char

要插入的 Char。

position

Int32

带格式的字符串中要插入字符的位置（从零开始计）。

testPosition

Int32

如果该方法成功，则为最后一个插入字符的位置；否则为第一次插入失败时所处的位置。 一个输出参数。

resultHint

MaskedTextResultHint

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

返回

Boolean

如果插入成功，则为 true；否则为 false。

注解

方法 InsertAt 将字符插入到参数指定的第一个编辑位置或超过 该 pos 位置。 此方法会将插入点之后的所有现有字符移一个位置，为插入 input 的字符腾出空间。 如果发生以下错误之一，则不执行插入，并且该方法返回 false。

• 参数 pos 小于零或大于 Length 格式化字符串的 。

• 在指定位置 处或超出指定位置 pos的带格式字符串中找不到可编辑字符。

• 插入字符 input不是有效的输入字符，因为它不可打印或与其对应的 mask 元素不匹配。

• 插入点右侧没有可用位置，因此无法移动现有字符。

• 移动现有字符将导致与掩码冲突。

空 input 字符串不会导致格式化字符串发生更改，但将返回 true。

另请参阅

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

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

public:
 bool InsertAt(System::String ^ input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool InsertAt (string input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.InsertAt : string * int * int * MaskedTextResultHint -> bool

Public Function InsertAt (input As String, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

参数

input

String

要插入的 String。

position

Int32

带格式的字符串中要插入输入字符串的位置（从零开始计）。

testPosition

Int32

如果该方法成功，则为最后一个插入字符的位置；否则为第一次插入失败时所处的位置。 一个输出参数。

resultHint

MaskedTextResultHint

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

返回

Boolean

如果插入成功，则为 true；否则为 false。

例外

ArgumentNullException

input 参数为 null。

注解

方法 InsertAt 将字符串中的每个 input 字符插入到位于位置及更高位置的编辑位置 pos 。 对于每个插入的字符，此方法会将插入点之后的所有现有字符移位一个位置。 如果发生以下错误之一，则不执行插入，并且该方法返回 false。

• 参数 pos 小于零或大于 Length 格式化字符串的 。

• 在指定位置 处或超出指定位置 pos的带格式字符串中存在足够的可编辑字符，无法插入字符串中的所有 input 字符。

• 一个或多个插入字符不是有效的输入字符，因为它们不可打印或与相应的掩码元素不匹配。

• 插入点右侧的可用位置不足，因此无法移动现有字符。

• 移动现有字符将导致与掩码冲突。 请注意，这种移动发生在插入每个单独的字符期间。

空 input 字符串不会导致格式化字符串发生更改，但将返回 true。

另请参阅

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString