MaskedTextProvider.InsertAt MaskedTextProvider.InsertAt MaskedTextProvider.InsertAt MaskedTextProvider.InsertAt Method

Определение

Вставляет знак или строку в заданную позицию форматируемой строки.Inserts a character or string at a specific position within the formatted string.

Перегрузки

InsertAt(Char, Int32) InsertAt(Char, Int32) InsertAt(Char, Int32) InsertAt(Char, Int32)

Вставляет заданный знак в заданную позицию форматируемой строки.Inserts the specified character at the specified position within the formatted string.

InsertAt(String, Int32) InsertAt(String, Int32) InsertAt(String, Int32) InsertAt(String, Int32)

Вставляет заданную строку в заданную позицию форматируемой строки.Inserts the specified string at a specified position within the formatted string.

InsertAt(Char, Int32, Int32, MaskedTextResultHint) InsertAt(Char, Int32, Int32, MaskedTextResultHint) InsertAt(Char, Int32, Int32, MaskedTextResultHint) InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Вставляет заданный знак в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.Inserts the specified character at the specified position within the formatted string, returning the last insertion position and the status of the operation.

InsertAt(String, Int32, Int32, MaskedTextResultHint) InsertAt(String, Int32, Int32, MaskedTextResultHint) InsertAt(String, Int32, Int32, MaskedTextResultHint) InsertAt(String, Int32, Int32, MaskedTextResultHint)

Вставляет заданную строку в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.Inserts the specified string at a specified position within the formatted string, returning the last insertion position and the status of the operation.

InsertAt(Char, Int32) InsertAt(Char, Int32) InsertAt(Char, Int32) InsertAt(Char, Int32)

Вставляет заданный знак в заданную позицию форматируемой строки.Inserts the specified character at the specified position within the formatted string.

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

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

position
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция для вставки знака в форматируемую строку.The zero-based position in the formatted string to insert the character.

Возвраты

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

Комментарии

Метод вставляет символ в первую точку редактирования в соответствии с pos параметром или после него. InsertAtThe InsertAt method inserts a character into the first edit position at or beyond that specified by the pos parameter. Этот метод переместит все существующие символы после точки вставки на одну позицию, чтобы освободить место для вставленного input символа.This method will shift all existing characters after the insertion point over by one position to make room for the inserted input character. При возникновении одной из следующих ошибок вставка не выполняется и метод возвращает falseзначение.If one of the following errors occurs, the insertion is not performed, and the method returns false.

  • Параметр имеет значение меньше нуля или больше значения 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 insertion character, input, is not a valid input character because it is not printable or does not match its corresponding mask element.

  • Справа от точки вставки нет доступных позиций, поэтому нельзя сдвинуть существующие символы.There are no available positions to the right of the insertion point, so that existing characters cannot be shifted.

  • Сдвиг существующих символов приведет к нарушению маски.Shifting the existing characters would produce a violation of the mask.

Пустая input строка не приведет к изменению отформатированной строки, но возвратит trueзначение.An empty input string will cause no change in the formatted string, but will return true.

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

InsertAt(String, Int32) InsertAt(String, Int32) InsertAt(String, Int32) InsertAt(String, Int32)

Вставляет заданную строку в заданную позицию форматируемой строки.Inserts the specified string at a specified position within the formatted string.

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

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

position
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция для вставки входной строки в форматируемую строку.The zero-based position in the formatted string to insert the input string.

Возвраты

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

Исключения

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

Комментарии

Метод вставляет каждый символ input из строки в позиции редактирования, расположенные в позиции pos и за пределами. InsertAtThe InsertAt method inserts each character from the input string into the edit positions located at position pos and beyond. Этот метод переместит все существующие символы после точки вставки на одну позицию для каждого вставленного символа.This method will shift all existing characters after the insertion point over by one position for each inserted character. При возникновении одной из следующих ошибок вставка не выполняется и метод возвращает falseзначение.If one of the following errors occurs, no insertion is performed, and the method returns false.

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

  • Недостаточно редактируемых символов в форматируемой строке с или за пределами указанной позиции, posчтобы вставить все символы input из строки.Not enough editable characters exist in the formatted string at or beyond the specified position, pos, to insert all of the characters from the input string.

  • Один или несколько символов вставки не являются допустимыми входными символами, так как они не печатаются или не соответствуют соответствующему элементу Mask.One or more of the insertion characters are not a valid input character because they are not printable or do not match their corresponding mask element.

  • Справа от точки вставки недостаточно доступных позиций, поэтому нельзя сдвинуть существующие символы.There are not enough available positions to the right of the insertion point, so that existing characters cannot be shifted.

  • Сдвиг существующих символов приведет к нарушению маски.Shifting the existing characters would produce a violation of the mask. Обратите внимание, что сдвиг выполняется во время вставки каждого отдельного символа.Note that this shifting occurs during the insertion of each individual character.

Пустая input строка не приведет к изменению отформатированной строки, но возвратит trueзначение.An empty input string will cause no change in the formatted string, but will return true.

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

InsertAt(Char, Int32, Int32, MaskedTextResultHint) InsertAt(Char, Int32, Int32, MaskedTextResultHint) InsertAt(Char, Int32, Int32, MaskedTextResultHint) InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Вставляет заданный знак в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.Inserts the specified character at the specified position within the formatted string, returning the last insertion position and the status of the operation.

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

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

position
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция для вставки знака в форматируемую строку.The zero-based position in the formatted string to insert the character.

testPosition
Int32 Int32 Int32 Int32

При успешном выполнении метода — последняя позиция, в которой был вставлен знак; в противном случае — первая позиция, вставка в которую закончилась неудачей.If the method is successful, the last position where a character was inserted; otherwise, the first position where the insertion failed. Выходной параметр.An output parameter.

resultHint
MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint

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

Возвраты

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

Комментарии

Метод вставляет символ в первую точку редактирования в соответствии с pos параметром или после него. InsertAtThe InsertAt method inserts a character into the first edit position at or beyond that specified by the pos parameter. Этот метод переместит все существующие символы после точки вставки на одну позицию, чтобы освободить место для вставленного input символа.This method will shift all existing characters after the insertion point over by one position to make room for the inserted input character. При возникновении одной из следующих ошибок вставка не выполняется и метод возвращает falseзначение.If one of the following errors occurs, the insertion is not performed, and the method returns false.

  • Параметр имеет значение меньше нуля или больше значения 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 insertion character, input, is not a valid input character because it is not printable or does not match its corresponding mask element.

  • Справа от точки вставки нет доступных позиций, поэтому нельзя сдвинуть существующие символы.There are no available positions to the right of the insertion point, so that existing characters cannot be shifted.

  • Сдвиг существующих символов приведет к нарушению маски.Shifting the existing characters would produce a violation of the mask.

Пустая input строка не приведет к изменению отформатированной строки, но возвратит trueзначение.An empty input string will cause no change in the formatted string, but will return true.

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

InsertAt(String, Int32, Int32, MaskedTextResultHint) InsertAt(String, Int32, Int32, MaskedTextResultHint) InsertAt(String, Int32, Int32, MaskedTextResultHint) InsertAt(String, Int32, Int32, MaskedTextResultHint)

Вставляет заданную строку в заданную позицию форматируемой строки, возвращая последнюю позицию вставки и статус операции.Inserts the specified string at a specified position within the formatted string, returning the last insertion position and the status of the operation.

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

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

position
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция для вставки входной строки в форматируемую строку.The zero-based position in the formatted string to insert the input string.

testPosition
Int32 Int32 Int32 Int32

При успешном выполнении метода — последняя позиция, в которой был вставлен знак; в противном случае — первая позиция, вставка в которую закончилась неудачей.If the method is successful, the last position where a character was inserted; otherwise, the first position where the insertion failed. Выходной параметр.An output parameter.

resultHint
MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint

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

Возвраты

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

Исключения

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

Комментарии

Метод вставляет каждый символ input из строки в позиции редактирования, расположенные в позиции pos и за пределами. InsertAtThe InsertAt method inserts each character from the input string into the edit positions located at position pos and beyond. Этот метод переместит все существующие символы после точки вставки на одну позицию для каждого вставленного символа.This method will shift all existing characters after the insertion point over by one position for each inserted character. При возникновении одной из следующих ошибок вставка не выполняется и метод возвращает falseзначение.If one of the following errors occurs, no insertion is performed, and the method returns false.

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

  • Недостаточно редактируемых символов в форматируемой строке с или за пределами указанной позиции, posчтобы вставить все символы input из строки.Not enough editable characters exist in the formatted string at or beyond the specified position, pos, to insert all of the characters from the input string.

  • Один или несколько символов вставки не являются допустимыми входными символами, так как они не печатаются или не соответствуют соответствующему элементу Mask.One or more of the insertion characters are not a valid input character because they are not printable or do not match their corresponding mask element.

  • Справа от точки вставки недостаточно доступных позиций, поэтому нельзя сдвинуть существующие символы.There are not enough available positions to the right of the insertion point, so that existing characters cannot be shifted.

  • Сдвиг существующих символов приведет к нарушению маски.Shifting the existing characters would produce a violation of the mask. Обратите внимание, что сдвиг выполняется во время вставки каждого отдельного символа.Note that this shifting occurs during the insertion of each individual character.

Пустая input строка не приведет к изменению отформатированной строки, но возвратит trueзначение.An empty input string will cause no change in the formatted string, but will return true.

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

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