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)

Исходный код:

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 указывает перед началом форматируемой строки или за ее концом.

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

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

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

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

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

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

Исходный код:

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)

Исходный код:

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 значение в форматируемой строке.

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

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

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

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

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

Replace(Char, Int32, Int32, MaskedTextResultHint)

Исходный код:

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)

Исходный код:

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 значение в форматируемой строке.

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

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

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

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

Replace(Char, Int32)

Исходный код:

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