Поделиться через


MaskedTextProvider.InsertAt Метод

Определение

Вставляет знак или строку в заданную позицию форматируемой строки.

Перегрузки

InsertAt(Char, Int32)

Вставляет заданный знак в заданную позицию форматируемой строки.

InsertAt(String, Int32)

Вставляет заданную строку в заданную позицию форматируемой строки.

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Вставляет заданный знак в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Вставляет заданную строку в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.

InsertAt(Char, Int32)

Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs

Вставляет заданный знак в заданную позицию форматируемой строки.

public:
 bool InsertAt(char input, int position);
public bool InsertAt (char input, int position);
member this.InsertAt : char * int -> bool
Public Function InsertAt (input As Char, position As Integer) As Boolean

Параметры

input
Char

Вставляемый объект Char.

position
Int32

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

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

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

Комментарии

Метод InsertAt вставляет символ в первую позицию редактирования, указанную параметром , или после нее pos . Этот метод сместит все существующие символы после точки вставки на одну позицию, чтобы освободить место для вставленного символа input . Если возникает одна из следующих ошибок, вставка не выполняется, а метод возвращает false.

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

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

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

  • Нет доступных позиций справа от точки вставки, поэтому существующие символы нельзя сдвинуть.

  • Смещение существующих символов приведет к нарушению маски.

Пустая input строка не приведет к изменению форматируемой строки, но возвращает true.

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

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

InsertAt(String, Int32)

Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs

Вставляет заданную строку в заданную позицию форматируемой строки.

public:
 bool InsertAt(System::String ^ input, int position);
public bool InsertAt (string input, int position);
member this.InsertAt : string * int -> bool
Public Function InsertAt (input As String, position As Integer) As Boolean

Параметры

input
String

Вставляемый объект String.

position
Int32

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

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

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

Исключения

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

Комментарии

Метод InsertAt вставляет каждый символ из строки в input позиции редактирования, расположенные в позиции pos и за ее пределами. Этот метод сместит все существующие символы после точки вставки на одну позицию для каждого вставленного символа. Если возникает одна из следующих ошибок, вставка не выполняется, и метод возвращает false.

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

  • Недостаточно редактируемых символов в отформатируемой строке в указанной позиции или за ее пределами, posчтобы вставить все символы из input строки.

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

  • Недостаточно доступных позиций справа от точки вставки, поэтому существующие символы нельзя сдвинуть.

  • Смещение существующих символов приведет к нарушению маски. Обратите внимание, что это смещение происходит во время вставки каждого отдельного символа.

Пустая input строка не приведет к изменению форматируемой строки, но возвращает true.

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

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

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs

Вставляет заданный знак в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.

public:
 bool InsertAt(char input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool InsertAt (char input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.InsertAt : char * int * int * MaskedTextResultHint -> bool
Public Function InsertAt (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.

Комментарии

Метод InsertAt вставляет символ в первую позицию редактирования, указанную параметром , или после нее pos . Этот метод сместит все существующие символы после точки вставки на одну позицию, чтобы освободить место для вставленного символа input . Если возникает одна из следующих ошибок, вставка не выполняется, а метод возвращает false.

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

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

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

  • Нет доступных позиций справа от точки вставки, поэтому существующие символы нельзя сдвинуть.

  • Смещение существующих символов приведет к нарушению маски.

Пустая input строка не приведет к изменению форматируемой строки, но возвращает true.

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

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

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs
Исходный код:
MaskedTextProvider.cs

Вставляет заданную строку в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.

public:
 bool InsertAt(System::String ^ input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool InsertAt (string input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.InsertAt : string * int * int * MaskedTextResultHint -> bool
Public Function InsertAt (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.

Исключения

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

Комментарии

Метод InsertAt вставляет каждый символ из строки в input позиции редактирования, расположенные в позиции pos и за ее пределами. Этот метод сместит все существующие символы после точки вставки на одну позицию для каждого вставленного символа. Если возникает одна из следующих ошибок, вставка не выполняется, и метод возвращает false.

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

  • Недостаточно редактируемых символов в отформатируемой строке в указанной позиции или за ее пределами, posчтобы вставить все символы из input строки.

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

  • Недостаточно доступных позиций справа от точки вставки, поэтому существующие символы нельзя сдвинуть.

  • Смещение существующих символов приведет к нарушению маски. Обратите внимание, что это смещение происходит во время вставки каждого отдельного символа.

Пустая input строка не приведет к изменению форматируемой строки, но возвращает true.

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

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