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