MaskedTextProvider.Add Метод

Определение

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

System.ComponentModel

Сборка:

System.ComponentModel.TypeConverter.dll

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

Перегрузки

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

Add(String, Int32, MaskedTextResultHint)

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

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

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

Boolean

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

Комментарии

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

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

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

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

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

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

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString

Add(Char, Int32, MaskedTextResultHint)

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

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

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

Boolean

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

Комментарии

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

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

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

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

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

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(Char)

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

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

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

Boolean

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

Комментарии

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

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

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

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

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(String)

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

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

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

Boolean

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

Исключения

ArgumentNullException

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

Комментарии

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

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

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

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

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

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString