MaskedTextProvider.Add MaskedTextProvider.Add MaskedTextProvider.Add MaskedTextProvider.Add Method

Определение

Добавляет в форматируемую строку введенный знак или введенную строку.Adds an input character or input string to the formatted string.

Перегрузки

Add(String, Int32, MaskedTextResultHint) Add(String, Int32, MaskedTextResultHint) Add(String, Int32, MaskedTextResultHint) Add(String, Int32, MaskedTextResultHint)

Добавляет знаки заданной входной строки в конец форматируемой строки, а затем выводит позицию и описательные сведения.Adds the characters in the specified input string to the end of the formatted string, and then outputs position and descriptive information.

Add(Char, Int32, MaskedTextResultHint) Add(Char, Int32, MaskedTextResultHint) Add(Char, Int32, MaskedTextResultHint) Add(Char, Int32, MaskedTextResultHint)

Добавляет заданный введенный знак в конец форматируемой строки, а затем выводит позицию и описательные сведения.Adds the specified input character to the end of the formatted string, and then outputs position and descriptive information.

Add(Char) Add(Char) Add(Char) Add(Char)

Добавляет указанный введенный знак в конец форматируемой строки.Adds the specified input character to the end of the formatted string.

Add(String) Add(String) Add(String) Add(String)

Добавляет в конец форматируемой строки знаки заданной входной строки.Adds the characters in the specified input string to the end of the formatted string.

Add(String, Int32, MaskedTextResultHint) Add(String, Int32, MaskedTextResultHint) Add(String, Int32, MaskedTextResultHint) Add(String, Int32, MaskedTextResultHint)

Добавляет знаки заданной входной строки в конец форматируемой строки, а затем выводит позицию и описательные сведения.Adds the characters in the specified input string to the end of the formatted string, and then outputs position and descriptive information.

public:
 bool Add(System::String ^ input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Add (string input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Add : string * int * MaskedTextResultHint -> bool
Public Function Add (input As String, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Параметры

input
String String String String

Строка String, содержащая значения знаков, добавляемых в форматируемую строку.A String containing character values to be appended to the formatted string.

testPosition
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция форматируемой строки, в которую была предпринята попытка добавить знак.The zero-based position in the formatted string where the attempt was made to add the character. Выходной параметр.An output parameter.

resultHint
MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint

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

Возвраты

Значение true, если все знаки входной строки были успешно добавлены; в противном случае — значение false, показывающее, что никакие знаки не были добавлены.true if all the characters from the input string were added successfully; otherwise false to indicate that no characters were added.

Комментарии

Метод добавляет символы input из строки в отформатированную строку, начиная с первой доступной позицией после LastAssignedPosition. Add(String, Int32, MaskedTextResultHint)The Add(String, Int32, MaskedTextResultHint) method adds the characters from the input string to the formatted string, starting with the first available position after LastAssignedPosition. Этот метод завершится ошибкой по одной из следующих причин:This method will fail for any of the following reasons:

  • Любой из символов во входном значении, input, не поддающийся печати, либо входное значение не соответствует соответствующему элементу Mask.Any of the characters in the input value, input, are not printable, or the input value does not match its corresponding mask element.

  • Недостаточно доступных позиций редактирования в форматируемой строке после последней назначенной позиции.There are not enough available edit positions in the formatted string after the last assigned position.

В случае сбоя этого метода никакие добавления не выполняются и метод возвращает falseзначение.If this method fails, no additions are made and the method returns false.

Этот метод работает так же, как переопределенная версия, принимающая String один Add(String)параметр, за исключением того, что он выводит дополнительные сведения.This method functions the same as the overridden version taking a single String parameter, Add(String), except that it outputs additional information.

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

Add(Char, Int32, MaskedTextResultHint) Add(Char, Int32, MaskedTextResultHint) Add(Char, Int32, MaskedTextResultHint) Add(Char, Int32, MaskedTextResultHint)

Добавляет заданный введенный знак в конец форматируемой строки, а затем выводит позицию и описательные сведения.Adds the specified input character to the end of the formatted string, and then outputs position and descriptive information.

public:
 bool Add(char input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Add (char input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Add : char * int * MaskedTextResultHint -> bool
Public Function Add (input As Char, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Параметры

input
Char Char Char Char

Значение Char, добавляемое в форматируемую строку.A Char value to be appended to the formatted string.

testPosition
Int32 Int32 Int32 Int32

Отсчитываемая от нуля позиция форматируемой строки, в которую была предпринята попытка добавить знак.The zero-based position in the formatted string where the attempt was made to add the character. Выходной параметр.An output parameter.

resultHint
MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint

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

Возвраты

Значение true, если введенный знак был успешно добавлен, в противном случае — значение false.true if the input character was added successfully; otherwise false.

Комментарии

Метод пытается input добавить значение символа в первую доступную точку форматируемой строки после последней назначенной позиции, LastAssignedPosition которая представлена свойством. Add(Char, Int32, MaskedTextResultHint)The Add(Char, Int32, MaskedTextResultHint) method attempts to add the input character value to the first available position in the formatted string after the position that was last assigned, which is represented by the LastAssignedPosition property. Этот метод завершится ошибкой, если все доступные позиции находятся перед последней назначенной позицией.This method will fail if all available positions are before the last assigned position. Этот метод завершится ошибкой по одной из следующих причин:This method will fail for any of the following reasons:

  • Входное значение, input, не может быть распечатано или не соответствует соответствующему элементу Mask.The input value, input, is not printable, or it does not match its corresponding mask element.

  • В форматированной строке есть нулевые позиции редактирования или нет доступных позиций редактирования после последней назначенной позиции.There are zero available edit positions in the formatted string, or there are no available edit positions after the last assigned position.

Этот метод работает так же, как переопределенная версия, принимающая Char один Add(Char)параметр, за исключением того, что он выводит дополнительные сведения.This method functions the same as the overridden version taking a single Char parameter, Add(Char), except that it outputs additional information.

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

Add(Char) Add(Char) Add(Char) Add(Char)

Добавляет указанный введенный знак в конец форматируемой строки.Adds the specified input character to the end of the formatted string.

public:
 bool Add(char input);
public bool Add (char input);
member this.Add : char -> bool
Public Function Add (input As Char) As Boolean

Параметры

input
Char Char Char Char

Значение Char, добавляемое в форматируемую строку.A Char value to be appended to the formatted string.

Возвраты

Значение true, если введенный знак был успешно добавлен, в противном случае — значение false.true if the input character was added successfully; otherwise false.

Комментарии

Метод добавляет значение символавLastAssignedPosition первую доступную точку форматируемой строки после последней назначенной позиции, которая представлена свойством. input Add(Char)The Add(Char) method adds the input character value to the first available position in the formatted string after the position that was last assigned, which is represented by the LastAssignedPosition property. Этот метод завершится ошибкой по одной из следующих причин:This method will fail for any of the following reasons:

  • Входное значение, input, не может быть распечатано или не соответствует соответствующему элементу Mask.The input value, input, is not printable, or it does not match its corresponding mask element.

  • В форматированной строке есть нулевые позиции редактирования или нет доступных позиций редактирования после последней назначенной позиции.There are zero available edit positions in the formatted string, or there are no available edit positions after the last assigned position.

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

Add(String) Add(String) Add(String) Add(String)

Добавляет в конец форматируемой строки знаки заданной входной строки.Adds the characters in the specified input string to the end of the formatted string.

public:
 bool Add(System::String ^ input);
public bool Add (string input);
member this.Add : string -> bool
Public Function Add (input As String) As Boolean

Параметры

input
String String String String

Строка String, содержащая значения знаков, добавляемых в форматируемую строку.A String containing character values to be appended to the formatted string.

Возвраты

Значение true, если все знаки входной строки были успешно добавлены; в противном случае — значение false, показывающее, что никакие знаки не были добавлены.true if all the characters from the input string were added successfully; otherwise false to indicate that no characters were added.

Исключения

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

Комментарии

Метод добавляет символы input из строки в отформатированную строку, начиная с первой доступной позицией после LastAssignedPosition. Add(String)The Add(String) method adds the characters from the input string to the formatted string, starting with the first available position after LastAssignedPosition. Этот метод завершится ошибкой по одной из следующих причин:This method will fail for any of the following reasons:

  • Любой из символов во входном значении, input, не поддающийся печати, либо входное значение не соответствует соответствующему элементу Mask.Any of the characters in the input value, input, are not printable, or the input value does not match its corresponding mask element.

  • Недостаточно доступных позиций редактирования в форматируемой строке после последней назначенной позиции.There are not enough available edit positions in the formatted string after the last assigned position.

В случае сбоя этого метода никакие добавления не выполняются и метод возвращает falseзначение.If this method fails, no additions are made and the method returns false.

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

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