MaskedTextProvider.Replace 方法

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.TypeConverter.dll

用指定的字符替换带格式字符串中的一个或多个可编辑字符。

重载

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)	在指定的开始位置和结束位置之间的范围内使用指定的字符串替换可编辑字符，然后输出移除位置和描述性信息。
Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)	在指定的开始和结束位置之间使用指定的字符值替换单个字符，然后输出移除位置和描述性信息。
Replace(String, Int32, Int32, MaskedTextResultHint)	从指定位置开始使用指定字符串替换一定范围的可编辑字符，然后输出移除位置和描述性信息。
Replace(Char, Int32, Int32, MaskedTextResultHint)	用指定的字符值替换指定位置或指定位置后面的单个字符，然后输出移除位置和描述性信息。
Replace(String, Int32)	从指定位置开始使用指定字符串替换一定范围的可编辑字符。
Replace(Char, Int32)	用指定的字符值替换指定位置或指定位置后面的单个字符。

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

Source:

MaskedTextProvider.cs

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

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

public bool Replace (string input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

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

Public Function Replace (input As String, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

参数

input

String

用于替换现有可编辑字符的 String 值。

startPosition

Int32

带格式的字符串中的替换起始位置（从零开始计）。

endPosition

Int32

带格式的字符串中的替换结束位置（从零开始计）。

testPosition

Int32

如果成功，则为带格式字符串中实际替换最后一个字符的位置（从零开始计）；否则为该操作第一次失败时所处的位置。 一个输出参数。

resultHint

MaskedTextResultHint

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

返回

Boolean

如果所有的字符已成功替换，则为 true；否则为 false。

注解

方法 Replace 在指定的起始和结束位置之间搜索格式化字符串中的第一个可编辑位置。 假设在此点之后有足够的可编辑位置，现有字符值将逐一替换为替换字符串参数 input的内容。

以下条件被视为错误。 发生错误时，不会发生替换，并 Replace 返回 false。

• startPos或 endPos 参数点在格式化字符串的开头之前或超出其末尾。

• 格式化字符串中没有足够的可编辑位置来保存替换字符串的内容。

• 其中一个替换字符值无效，因为它不可打印或与相应的掩码元素不匹配。

除了返回值，此方法还有两个输出参数，用于提供有关替换操作的其他信息。

另请参阅

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

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

Source:

MaskedTextProvider.cs

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

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

public bool Replace (char input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

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

Public Function Replace (input As Char, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

参数

input

Char

用于替换现有值的 Char 值。

startPosition

Int32

带格式的字符串中的替换起始位置（从零开始计）。

endPosition

Int32

带格式的字符串中的替换结束位置（从零开始计）。

testPosition

Int32

如果成功，则为带格式字符串中实际替换最后一个字符的位置（从零开始计）；否则为该操作第一次失败时所处的位置。 一个输出参数。

resultHint

MaskedTextResultHint

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

返回

Boolean

如果已成功替换该字符，则为 true；否则为 false。

注解

方法 Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) 在指定的起始和结束位置之间搜索格式化字符串中的第一个可编辑位置。 如果找到一个，则可编辑位置的值将更改为指定的字符 input。 以下任何条件都将导致错误条件，导致不执行替换，并返回 值 false ：

• startPos或 endPos 参数点在格式化字符串的开头之前或超出其末尾。

• 在指定的时间间隔内找不到可编辑字符。

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

除了返回值，此方法还有两个输出参数，用于提供有关替换操作的其他信息。

另请参阅

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(String, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

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

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

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

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

Public Function Replace (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。

注解

方法 Replace(String, Int32, Int32, MaskedTextResultHint) 搜索指定位置或之后的第一个可编辑位置 pos。 假设在此点之后有足够的可编辑位置，现有字符值将逐一替换为替换字符串参数 input的内容。

以下条件被视为错误。 发生错误时，不会发生替换，并 Replace(String, Int32, Int32, MaskedTextResultHint) 返回 false。

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

• 格式化字符串中没有足够的可编辑位置来保存替换字符串的内容。

• 其中一个替换字符值无效，因为它不可打印或与相应的掩码元素不匹配。

除了返回值，此方法还有两个输出参数，用于提供有关替换操作的其他信息。

另请参阅

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(Char, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

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

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

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

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

Public Function Replace (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。

注解

方法 Replace(Char, Int32, Int32, MaskedTextResultHint) 在指定位置 处或之后搜索格式化字符串中的第一个可编辑位置 pos。 如果找到一个，则可编辑位置的值将更改为指定的字符 input。 以下任何条件都将导致错误条件，导致不执行替换，并返回 值 false ：

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

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

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

除了返回值，此方法还有两个输出参数，用于提供有关替换操作的其他信息。

另请参阅

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(String, Int32)

Source:

MaskedTextProvider.cs

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

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

public bool Replace (string input, int position);

member this.Replace : string * int -> bool

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

参数

input

String

用于替换现有可编辑字符的 String 值。

position

Int32

用于搜索将要替换的第一个可编辑字符的位置（从零开始计）。

返回

Boolean

如果所有的字符已成功替换，则为 true；否则为 false。

例外

ArgumentNullException

input 参数为 null。

注解

方法 Replace(String, Int32) 搜索指定位置或之后的第一个可编辑位置 pos。 假设在此点之后有足够的可编辑位置，现有字符值将逐个替换为替换字符串参数 input的内容。

以下条件被视为错误。 发生错误时，不会发生替换，并 Replace(String, Int32) 返回 false。

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

• 格式化字符串中没有足够的可编辑位置来保存替换字符串的内容。

• 其中一个替换字符值无效，因为它不可打印或与相应的掩码元素不匹配。

另请参阅

• IsValidInputChar(Char)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set

Replace(Char, Int32)

Source:

MaskedTextProvider.cs

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

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

public bool Replace (char input, int position);

member this.Replace : char * int -> bool

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

参数

input

Char

用于替换现有值的 Char 值。

position

Int32

用于搜索将要替换的第一个可编辑字符的位置（从零开始计）。

返回

Boolean

如果已成功替换该字符，则为 true；否则为 false。

注解

方法 Replace(Char, Int32) 在指定位置 处或之后搜索格式化字符串中的第一个可编辑位置 pos。 如果找到一个，则可编辑位置的值将更改为指定的字符 input。 以下任何条件都将导致错误，导致不执行替换，并返回 值 false ：

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

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

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

另请参阅

• IsValidInputChar(Char)
• FindEditPositionFrom(Int32, Boolean)
• Add
• Clear
• InsertAt
• Remove
• RemoveAt
• Set