MaskedTextProvider.InsertAt Метод

Определение

Пространство имен:

System.ComponentModel

Сборка:

System.ComponentModel.TypeConverter.dll

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

Перегрузки

InsertAt(Char, Int32)	Вставляет заданный знак в заданную позицию форматируемой строки.
InsertAt(String, Int32)	Вставляет заданную строку в заданную позицию форматируемой строки.
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Вставляет заданный знак в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Вставляет заданную строку в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.

InsertAt(Char, Int32)

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

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

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

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

Boolean

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

Комментарии

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

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

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

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

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

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

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

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

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32)

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

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

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

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

Boolean

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

Исключения

ArgumentNullException

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

Комментарии

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

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

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

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

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

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

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

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

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

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

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

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

Boolean

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

Комментарии

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

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

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

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

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

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

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

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

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32, Int32, MaskedTextResultHint)

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

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

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

Boolean

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

Исключения

ArgumentNullException

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

Комментарии

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

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

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

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

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

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

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

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

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString