MaskedTextProvider.Replace MaskedTextProvider.Replace MaskedTextProvider.Replace MaskedTextProvider.Replace Method

Определение

Заменяет один или несколько редактируемых знаков в форматируемой строке на заданные знаки.Replaces one or more editable characters in the formatted string with the specified characters.

Перегрузки

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

Заменяет диапазон редактируемых знаков между заданными начальной и конечной позициями на заданную строку, а затем выводит позицию удаления и описательные сведения.Replaces a range of editable characters between the specified starting and ending positions with the specified string, and then outputs the removal position and descriptive information.

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

Заменяет один знак, начиная между заданными начальной и конечной позициями, на заданный знак, а затем выводит позицию удаления и описательные сведения.Replaces a single character between the specified starting and ending positions with the specified character value, and then outputs the removal position and descriptive information.

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

Заменяет диапазон редактируемых знаков, начиная с заданной позиции, на заданную строку, а затем выводит позицию удаления и описательные сведения.Replaces a range of editable characters starting at the specified position with the specified string, and then outputs the removal position and descriptive information.

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

Заменяет один знак, начиная с заданной позиции, на заданный знак, а затем выводит позицию удаления и описательные сведения.Replaces a single character at or beyond the specified position with the specified character value, and then outputs the removal position and descriptive information.

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

Заменяет диапазон редактируемых знаков, начиная с заданной позиции в заданной строке.Replaces a range of editable characters starting at the specified position with the specified string.

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

Заменяет один знак в заданной позиции или после нее на заданный знак.Replaces a single character at or beyond the specified position with the specified character value.

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

Заменяет диапазон редактируемых знаков между заданными начальной и конечной позициями на заданную строку, а затем выводит позицию удаления и описательные сведения.Replaces a range of editable characters between the specified starting and ending positions with the specified string, and then outputs the removal position and descriptive information.

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 String String

Значение String, используемое для замены существующих редактируемых знаков.The String value used to replace the existing editable characters.

startPosition
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция в форматируемой строке, с которой начинается замена.The zero-based position in the formatted string where the replacement starts.

endPosition
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция в форматируемой строке, которой заканчивается замена.The zero-based position in the formatted string where the replacement ends.

testPosition
Int32 Int32 Int32 Int32

При удачном удалении отсчитываемая от нуля позиция в форматируемой строке, в которой был фактически заменен последний знак; в противном случае — первая позиция, в которой выполнение операции закончилось неудачей.If successful, the zero-based position in the formatted string where the last character was actually replaced; otherwise, the first position where the operation failed. Выходной параметр.An output parameter.

resultHint
MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint

Объект MaskedTextResultHint, кратко описывающий результат операции замены.A MaskedTextResultHint that succinctly describes the result of the replacement operation. Выходной параметр.An output parameter.

Возвраты

Значение true при успешной замене всех знаков; в противном случае — значение false.true if all the characters were successfully replaced; otherwise, false.

Комментарии

Replace Метод выполняет поиск первой редактируемой позиции в форматируемой строке между заданными начальными и конечными позициями.The Replace method searches for the first editable position in the formatted string between the specified starting and ending positions. При использовании предположения, что после этой точки достаточно редактируемых позиций, существующие значения символов заменяются по одному на содержимое параметра inputстроки замены.Operating on the assumption that there are enough editable positions after this point, the existing character values are replaced one-by-one with the contents of the replacement string parameter, input.

Следующие условия считаются ошибками.The following conditions are considered errors. При возникновении ошибки замена не выполняется и Replace возвращает. falseWhen an error occurs, no replacement occurs and Replace returns false.

  • Параметр startPos илиendPos указывает до начала форматируемой строки или после ее окончания.The startPos or endPos parameters point before the start of the formatted string or beyond its end.

  • В форматируемой строке недостаточно редактируемых позиций для хранения содержимого замещающей строки.There are not enough editable positions in the formatted string to hold the contents of the replacement string.

  • Одно из значений символов замены недопустимо, так как оно не печатается или не соответствует соответствующему элементу Mask.One of the replacement character values is not valid because it is not printable or does not match its corresponding mask element.

Помимо возвращаемого значения, этот метод имеет два выходных параметра для предоставления дополнительных сведений об операции замены.In addition to the return value, this method has two output parameters to supply additional information about the replacement operation.

Дополнительно

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

Заменяет один знак, начиная между заданными начальной и конечной позициями, на заданный знак, а затем выводит позицию удаления и описательные сведения.Replaces a single character between the specified starting and ending positions with the specified character value, and then outputs the removal position and descriptive information.

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 Char Char

Значение Char, заменяющее существующее значение.The Char value that replaces the existing value.

startPosition
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция в форматируемой строке, с которой начинается замена.The zero-based position in the formatted string where the replacement starts.

endPosition
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция в форматируемой строке, которой заканчивается замена.The zero-based position in the formatted string where the replacement ends.

testPosition
Int32 Int32 Int32 Int32

При удачном удалении отсчитываемая от нуля позиция в форматируемой строке, в которой был фактически заменен последний знак; в противном случае — первая позиция, в которой выполнение операции закончилось неудачей.If successful, the zero-based position in the formatted string where the last character was actually replaced; otherwise, the first position where the operation failed. Выходной параметр.An output parameter.

resultHint
MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint

Объект MaskedTextResultHint, кратко описывающий результат операции замены.A MaskedTextResultHint that succinctly describes the result of the replacement operation. Выходной параметр.An output parameter.

Возвраты

Значение true, если знак успешно заменен, в противном случае — значение false.true if the character was successfully replaced; otherwise, false.

Комментарии

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) Метод выполняет поиск первой редактируемой позиции в форматируемой строке между заданными начальными и конечными позициями.The Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) method searches for the first editable position in the formatted string between the specified starting and ending positions. Если он найден, значение редактируемой позиции изменяется на указанный символ, input.If one is found, the value of the editable position is changed to the specified character, input. Любое из следующих условий приведет к ошибке, которая не приведет к выполнению замены и возврату значения false :Any of the following conditions will result in an error condition that causes no replacement to be performed and a value of false to be returned:

  • Параметр startPos илиendPos указывает до начала форматируемой строки или после ее окончания.The startPos or endPos parameters point before the start of the formatted string or beyond its end.

  • Редактируемый символ не найден в указанном интервале.An editable character was not found in the specified interval.

  • Символ замены,, inputне является допустимым входным символом, так как он не печатается или не соответствует соответствующему элементу Mask.The replacement character, input, is not a valid input character because it is not printable or does not match its corresponding mask element.

Помимо возвращаемого значения, этот метод имеет два выходных параметра для предоставления дополнительных сведений об операции замены.In addition to the return value, this method has two output parameters to supply additional information about the replacement operation.

Дополнительно

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

Заменяет диапазон редактируемых знаков, начиная с заданной позиции, на заданную строку, а затем выводит позицию удаления и описательные сведения.Replaces a range of editable characters starting at the specified position with the specified string, and then outputs the removal position and descriptive information.

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 String String

Значение String, используемое для замены существующих редактируемых знаков.The String value used to replace the existing editable characters.

position
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция, с которой начинается поиск первого редактируемого знака для замены.The zero-based position to search for the first editable character to replace.

testPosition
Int32 Int32 Int32 Int32

При удачном удалении отсчитываемая от нуля позиция в форматируемой строке, в которой был фактически заменен последний знак; в противном случае — первая позиция, в которой выполнение операции закончилось неудачей.If successful, the zero-based position in the formatted string where the last character was actually replaced; otherwise, the first position where the operation failed. Выходной параметр.An output parameter.

resultHint
MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint

Объект MaskedTextResultHint, кратко описывающий результат операции замены.A MaskedTextResultHint that succinctly describes the result of the replacement operation. Выходной параметр.An output parameter.

Возвраты

Значение true при успешной замене всех знаков; в противном случае — значение false.true if all the characters were successfully replaced; otherwise, false.

Комментарии

Метод выполняет поиск первой редактируемой позиции в указанной posпозиции или за ее пределами. Replace(String, Int32, Int32, MaskedTextResultHint)The Replace(String, Int32, Int32, MaskedTextResultHint) method searches for the first editable position at or beyond the specified position, pos. При использовании предположения, что после этой точки достаточно редактируемых позиций, существующие значения символов заменяются по одному на содержимое параметра inputстроки замены.Operating on the assumption that there are enough editable positions after this point, the existing character values are replaced one-by-one with the contents of the replacement string parameter, input.

Следующие условия считаются ошибками.The following conditions are considered errors. При возникновении ошибки замена не выполняется и Replace(String, Int32, Int32, MaskedTextResultHint) возвращает. falseWhen an error occurs, no replacement occurs and Replace(String, Int32, Int32, MaskedTextResultHint) returns false.

  • Параметр имеет значение меньше нуля или больше значения Length форматируемой строки. posThe pos parameter is less than zero or greater than the Length of the formatted string.

  • В форматируемой строке недостаточно редактируемых позиций для хранения содержимого замещающей строки.There are not enough editable positions in the formatted string to hold the contents of the replacement string.

  • Одно из значений символов замены недопустимо, так как оно не печатается или не соответствует соответствующему элементу Mask.One of the replacement character values is not valid because it is not printable or does not match its corresponding mask element.

Помимо возвращаемого значения, этот метод имеет два выходных параметра для предоставления дополнительных сведений об операции замены.In addition to the return value, this method has two output parameters to supply additional information about the replacement operation.

Дополнительно

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

Заменяет один знак, начиная с заданной позиции, на заданный знак, а затем выводит позицию удаления и описательные сведения.Replaces a single character at or beyond the specified position with the specified character value, and then outputs the removal position and descriptive information.

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 Char Char

Значение Char, заменяющее существующее значение.The Char value that replaces the existing value.

position
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция, с которой начинается поиск первого редактируемого знака для замены.The zero-based position to search for the first editable character to replace.

testPosition
Int32 Int32 Int32 Int32

При удачном удалении отсчитываемая от нуля позиция в форматируемой строке, в которой был фактически заменен последний знак; в противном случае — первая позиция, в которой выполнение операции закончилось неудачей.If successful, the zero-based position in the formatted string where the last character was actually replaced; otherwise, the first position where the operation failed. Выходной параметр.An output parameter.

resultHint
MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint

Объект MaskedTextResultHint, кратко описывающий результат операции замены.A MaskedTextResultHint that succinctly describes the result of the replacement operation. Выходной параметр.An output parameter.

Возвраты

Значение true, если знак успешно заменен, в противном случае — значение false.true if the character was successfully replaced; otherwise, false.

Комментарии

Метод выполняет поиск первой редактируемой позиции в форматируемой строке в указанной posпозиции или за ее пределами. Replace(Char, Int32, Int32, MaskedTextResultHint)The Replace(Char, Int32, Int32, MaskedTextResultHint) method searches for the first editable position in the formatted string at or beyond the specified position, pos. Если он найден, значение редактируемой позиции изменяется на указанный символ, input.If one is found, the value of the editable position is changed to the specified character, input. Любое из следующих условий приведет к ошибке, которая не приведет к выполнению замены и возврату значения false :Any of the following conditions will result in an error condition that causes no replacement to be performed and a value of false to be returned:

  • Параметр имеет значение меньше нуля или больше значения Length форматируемой строки. posThe pos parameter is less than zero or greater than the Length of the formatted string.

  • Редактируемый символ не найден в форматируемой строке, posнаходящейся в указанной позиции или после нее.An editable character was not found in the formatted string at or beyond the specified position, pos.

  • Символ замены,, inputне является допустимым входным символом, так как он не печатается или не соответствует соответствующему элементу Mask.The replacement character, input, is not a valid input character because it is not printable or does not match its corresponding mask element.

Помимо возвращаемого значения, этот метод имеет два выходных параметра для предоставления дополнительных сведений об операции замены.In addition to the return value, this method has two output parameters to supply additional information about the replacement operation.

Дополнительно

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

Заменяет диапазон редактируемых знаков, начиная с заданной позиции в заданной строке.Replaces a range of editable characters starting at the specified position with the specified string.

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 String String

Значение String, используемое для замены существующих редактируемых знаков.The String value used to replace the existing editable characters.

position
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция, с которой начинается поиск первого редактируемого знака для замены.The zero-based position to search for the first editable character to replace.

Возвраты

Значение true при успешной замене всех знаков; в противном случае — значение false.true if all the characters were successfully replaced; otherwise, false.

Исключения

Параметр input имеет значение null.The input parameter is null.

Комментарии

Метод выполняет поиск первой редактируемой позиции в указанной posпозиции или за ее пределами. Replace(String, Int32)The Replace(String, Int32) method searches for the first editable position at or beyond the specified position, pos. При использовании в соответствии с предположением, что после этой точки достаточно редактируемых позиций, существующие символьные значения заменяются по одному на содержимое параметра inputстроки замены.Operating under the assumption that there are enough editable positions after this point, the existing character values are replaced one-by-one with the contents of the replacement string parameter, input.

Следующие условия считаются ошибками.The following conditions are considered errors. При возникновении ошибки замена не выполняется и Replace(String, Int32) возвращает. falseWhen an error occurs, no replacement occurs and Replace(String, Int32) returns false.

  • Параметр имеет значение меньше нуля или больше значения Length форматируемой строки. posThe pos parameter is less than zero or greater than the Length of the formatted string.

  • В форматируемой строке недостаточно редактируемых позиций для хранения содержимого замещающей строки.There are not enough editable positions in the formatted string to hold the contents of the replacement string.

  • Одно из значений символов замены недопустимо, так как оно не печатается или не соответствует соответствующему элементу Mask.One of the replacement character values is not valid because it is not printable or does not match its corresponding mask element.

Дополнительно

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

Заменяет один знак в заданной позиции или после нее на заданный знак.Replaces a single character at or beyond the specified position with the specified character value.

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 Char Char

Значение Char, заменяющее существующее значение.The Char value that replaces the existing value.

position
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция, с которой начинается поиск первого редактируемого знака для замены.The zero-based position to search for the first editable character to replace.

Возвраты

Значение true, если знак успешно заменен, в противном случае — значение false.true if the character was successfully replaced; otherwise, false.

Комментарии

Метод выполняет поиск первой редактируемой позиции в форматируемой строке в указанной posпозиции или за ее пределами. Replace(Char, Int32)The Replace(Char, Int32) method searches for the first editable position in the formatted string at or beyond the specified position, pos. Если он найден, значение редактируемой позиции изменяется на указанный символ, input.If one is found, the value of the editable position is changed to the specified character, input. Любое из следующих условий приведет к ошибке, которая не приводит к выполнению замены и возвращению значения false :Any of the following conditions will result in an error that causes no replacement to be performed and a value of false to be returned:

  • Параметр имеет значение меньше нуля или больше значения Length форматируемой строки. posThe pos parameter is less than zero or greater than the Length of the formatted string.

  • Редактируемый символ не найден в форматируемой строке, posнаходящейся в указанной позиции или после нее.An editable character was not found in the formatted string at or beyond the specified position, pos.

  • Символ замены,, inputне является допустимым входным символом, так как он не печатается или не соответствует соответствующему элементу Mask.The replacement character, input, is not a valid input character because it is not printable or does not match its corresponding mask element.

Дополнительно

Применяется к