MaskedTextProvider.Replace Метод

Определение

Заменяет один или несколько редактируемых знаков в форматируемой строке на заданные знаки.

Перегрузки

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)

Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs
Исходный код:
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, кратко описывающий результат операции замены. Выходной параметр.

Возвращаемое значение

Значение true при успешной замене всех знаков; в противном случае — значение false.

Комментарии

Метод Replace ищет первую редактируемую позицию в форматируемой строке между указанной начальной и конечной позициями. Исходя из предположения, что после этого момента будет достаточно редактируемых позиций, существующие символьные значения заменяются по очереди содержимым параметра строки замены , input.

Следующие условия считаются ошибками. При возникновении ошибки замена не выполняется и Replace возвращается false.

  • Параметр startPos или endPos указывает перед началом форматируемой строки или за ее концом.

  • В форматируемой строке недостаточно редактируемых позиций для хранения содержимого строки замены.

  • Одно из символов замены является недопустимым, так как оно не доступно для печати или не соответствует соответствующему элементу mask.

Помимо возвращаемого значения, этот метод имеет два выходных параметра для предоставления дополнительных сведений об операции замены.

См. также раздел

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

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

Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs
Исходный код:
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, кратко описывающий результат операции замены. Выходной параметр.

Возвращаемое значение

Значение true, если знак успешно заменен, в противном случае — значение false.

Комментарии

Метод Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) ищет первую редактируемую позицию в форматируемой строке между указанной начальной и конечной позициями. Если он найден, значение редактируемой позиции изменяется на указанный символ , input. Любое из следующих условий приведет к ошибке, которая приведет к тому, что замена не выполняется и возвращается значение false :

  • Параметр startPos или endPos указывает перед началом форматируемой строки или за ее концом.

  • Редактируемый символ не найден в заданном интервале.

  • Замещающий символ , , не является допустимым входным символом, inputтак как он не печатается или не соответствует соответствующему элементу маски.

Помимо возвращаемого значения, этот метод имеет два выходных параметра для предоставления дополнительных сведений об операции замены.

См. также раздел

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

Replace(String, Int32, Int32, MaskedTextResultHint)

Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs
Исходный код:
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, кратко описывающий результат операции замены. Выходной параметр.

Возвращаемое значение

Значение true при успешной замене всех знаков; в противном случае — значение false.

Комментарии

Метод Replace(String, Int32, Int32, MaskedTextResultHint) ищет первую редактируемую позицию в указанной позиции или за ней, pos. Исходя из предположения, что после этого момента будет достаточно редактируемых позиций, существующие символьные значения заменяются по очереди содержимым параметра строки замены , input.

Следующие условия считаются ошибками. При возникновении ошибки замена не выполняется и Replace(String, Int32, Int32, MaskedTextResultHint) возвращается false.

  • Значение pos параметра меньше нуля или больше, чем Length значение в форматируемой строке.

  • В форматируемой строке недостаточно редактируемых позиций для хранения содержимого строки замены.

  • Одно из символов замены является недопустимым, так как оно не доступно для печати или не соответствует соответствующему элементу mask.

Помимо возвращаемого значения, этот метод имеет два выходных параметра для предоставления дополнительных сведений об операции замены.

См. также раздел

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

Replace(Char, Int32, Int32, MaskedTextResultHint)

Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs
Исходный код:
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, кратко описывающий результат операции замены. Выходной параметр.

Возвращаемое значение

Значение true, если знак успешно заменен, в противном случае — значение false.

Комментарии

Метод Replace(Char, Int32, Int32, MaskedTextResultHint) ищет первую редактируемую позицию в форматируемой строке в указанной позиции или за ней, pos. Если он найден, значение редактируемой позиции изменяется на указанный символ , input. Любое из следующих условий приведет к ошибке, которая приведет к тому, что замена не выполняется и возвращается значение false :

  • Значение pos параметра меньше нуля или больше, чем Length значение в форматируемой строке.

  • Редактируемый символ не найден в форматируемой строке в указанной позиции или за ее пределами. pos

  • Замещающий символ , , не является допустимым входным символом, inputтак как он не печатается или не соответствует соответствующему элементу маски.

Помимо возвращаемого значения, этот метод имеет два выходных параметра для предоставления дополнительных сведений об операции замены.

См. также раздел

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

Replace(String, Int32)

Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs
Исходный код:
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

Отсчитываемая от нуля позиция, с которой начинается поиск первого редактируемого знака для замены.

Возвращаемое значение

Значение true при успешной замене всех знаков; в противном случае — значение false.

Исключения

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

Комментарии

Метод Replace(String, Int32) ищет первую редактируемую позицию в указанной позиции или за ней, pos. При условии, что после этого момента будет достаточно редактируемых позиций, существующие символьные значения заменяются по очереди на содержимое замещающего строкового параметра . input

Следующие условия считаются ошибками. При возникновении ошибки замена не выполняется и Replace(String, Int32) возвращается false.

  • Значение pos параметра меньше нуля или больше, чем Length значение в форматируемой строке.

  • В форматируемой строке недостаточно редактируемых позиций для хранения содержимого строки замены.

  • Одно из символов замены является недопустимым, так как оно не доступно для печати или не соответствует соответствующему элементу mask.

См. также раздел

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

Replace(Char, Int32)

Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs
Исходный код:
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

Отсчитываемая от нуля позиция, с которой начинается поиск первого редактируемого знака для замены.

Возвращаемое значение

Значение true, если знак успешно заменен, в противном случае — значение false.

Комментарии

Метод Replace(Char, Int32) ищет первую редактируемую позицию в форматируемой строке в указанной позиции или за ней, pos. Если он найден, значение редактируемой позиции изменяется на указанный символ , input. Любое из следующих условий приведет к ошибке, которая приведет к тому, что замена не выполняется и возвращается значение false :

  • Значение pos параметра меньше нуля или больше, чем Length значение в форматируемой строке.

  • Редактируемый символ не найден в форматируемой строке в указанной позиции или за ее пределами. pos

  • Замещающий символ , , не является допустимым входным символом, inputтак как он не печатается или не соответствует соответствующему элементу маски.

См. также раздел

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