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


MaskedTextProvider.Add Метод

Определение

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

Перегрузки

Add(String, Int32, MaskedTextResultHint)

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

Add(Char, Int32, MaskedTextResultHint)

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

Add(Char)

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

Add(String)

Добавляет в конец форматируемой строки знаки заданной входной строки.

Add(String, Int32, MaskedTextResultHint)

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

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

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, содержащая значения знаков, добавляемых в форматируемую строку.

testPosition
Int32

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

resultHint
MaskedTextResultHint

Объект MaskedTextResultHint, кратко описывающий результат операции. Выходной параметр.

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

Значение true, если все знаки входной строки были успешно добавлены; в противном случае — значение false, показывающее, что никакие знаки не были добавлены.

Комментарии

Метод Add(String, Int32, MaskedTextResultHint) добавляет символы из строки в input форматированную строку, начиная с первой доступной позиции после LastAssignedPosition. Этот метод завершится ошибкой по любой из следующих причин:

  • Любые символы во входном значении , input, не могут быть напечатаны, или входное значение не соответствует соответствующему элементу маски.

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

Если этот метод завершается сбоем, добавления не выполняются и метод возвращает false.

Этот метод работает так же, как переопределенная версия с одним String параметром , за исключением того, Add(String)что он выводит дополнительные сведения.

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

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

Add(Char, Int32, MaskedTextResultHint)

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

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

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, добавляемое в форматируемую строку.

testPosition
Int32

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

resultHint
MaskedTextResultHint

Объект MaskedTextResultHint, кратко описывающий результат операции. Выходной параметр.

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

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

Комментарии

Метод Add(Char, Int32, MaskedTextResultHint) пытается добавить символьное input значение в первую доступную позицию в форматируемой строке после последней назначенной позиции, которая представлена свойством LastAssignedPosition . Этот метод завершится ошибкой, если все доступные позиции находятся до последней назначенной позиции. Этот метод завершится ошибкой по любой из следующих причин:

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

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

Этот метод работает так же, как переопределенная версия с одним Char параметром , за исключением того, Add(Char)что он выводит дополнительные сведения.

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

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

Add(Char)

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

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

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, добавляемое в форматируемую строку.

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

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

Комментарии

Метод Add(Char) добавляет значение символа input в первую доступную позицию в отформатируемой строке после последней назначенной позиции, которая представлена свойством LastAssignedPosition . Этот метод завершится ошибкой по любой из следующих причин:

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

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

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

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

Add(String)

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

Добавляет в конец форматируемой строки знаки заданной входной строки.

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, содержащая значения знаков, добавляемых в форматируемую строку.

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

Значение true, если все знаки входной строки были успешно добавлены; в противном случае — значение false, показывающее, что никакие знаки не были добавлены.

Исключения

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

Комментарии

Метод Add(String) добавляет символы из строки в input форматированную строку, начиная с первой доступной позиции после LastAssignedPosition. Этот метод завершится ошибкой по любой из следующих причин:

  • Любые символы во входном значении , input, не могут быть напечатаны, или входное значение не соответствует соответствующему элементу маски.

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

Если этот метод завершается сбоем, добавления не выполняются и метод возвращает false.

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

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