MaskedTextProvider.Set MaskedTextProvider.Set MaskedTextProvider.Set MaskedTextProvider.Set Method

Определение

Определяет форматируемую строку для заданной входной строки.Sets the formatted string to the specified input string.

Перегрузки

Set(String) Set(String) Set(String) Set(String)

Определяет форматируемую строку для заданной входной строки.Sets the formatted string to the specified input string.

Set(String, Int32, MaskedTextResultHint) Set(String, Int32, MaskedTextResultHint) Set(String, Int32, MaskedTextResultHint) Set(String, Int32, MaskedTextResultHint)

Устанавливает форматируемую строку равной заданной входной строке, а затем выводит позицию удаления и описательные сведения.Sets the formatted string to the specified input string, and then outputs the removal position and descriptive information.

Set(String) Set(String) Set(String) Set(String)

Определяет форматируемую строку для заданной входной строки.Sets the formatted string to the specified input string.

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

Параметры

input
String String String String

Значение String, используемое для задания форматируемой строки.The String value used to set the formatted string.

Возвраты

Значение true при успешной установке всех знаков; в противном случае — значение false.true if all the characters were successfully set; otherwise, false.

Исключения

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

Комментарии

Метод очищает существующее содержимое форматируемой строки, а затем применяет маску input к строке для обновления содержимого форматированной строки. SetThe Set method clears the existing contents of the formatted string and then applies the mask against the input string to update the contents of the formatted string.

Следующие условия считаются ошибками.The following conditions are considered errors. При возникновении ошибки отформатированная строка остается неизменной и Set возвращает false.When an error occurs, the formatted string remains unaltered and Set returns false.

  • В форматируемой строке недостаточно редактируемых позиций для хранения содержимого замещающей строки.There are not enough editable positions in the formatted string to hold the contents of the replacement string.

  • Одно из значений символов замены недопустимо, так как оно не печатается или не соответствует соответствующему элементу Mask.One of the replacement character values is not valid because it is not printable or does not match its corresponding mask element.

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

Set(String, Int32, MaskedTextResultHint) Set(String, Int32, MaskedTextResultHint) Set(String, Int32, MaskedTextResultHint) Set(String, Int32, MaskedTextResultHint)

Устанавливает форматируемую строку равной заданной входной строке, а затем выводит позицию удаления и описательные сведения.Sets the formatted string to the specified input string, and then outputs the removal position and descriptive information.

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

Параметры

input
String String String String

Значение String, используемое для задания форматируемой строки.The String value used to set the formatted string.

testPosition
Int32 Int32 Int32 Int32

При удачном удалении отсчитываемая от нуля позиция в форматируемой строке, в которой был фактически установлен последний знак; в противном случае — первая позиция, в которой выполнение операции закончилось неудачей.If successful, the zero-based position in the formatted string where the last character was actually set; otherwise, the first position where the operation failed. Выходной параметр.An output parameter.

resultHint
MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint MaskedTextResultHint

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

Возвраты

Значение true при успешной установке всех знаков; в противном случае — значение false.true if all the characters were successfully set; otherwise, false.

Исключения

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

Комментарии

Метод очищает существующее содержимое форматируемой строки, а затем применяет маску input к строке для обновления содержимого форматированной строки. SetThe Set method clears the existing contents of the formatted string and then applies the mask against the input string to update the contents of the formatted string.

Следующие условия считаются ошибками.The following conditions are considered errors. При возникновении ошибки отформатированная строка остается неизменной и Set возвращает false.When an error occurs, the formatted string remains unaltered and Set returns false.

  • В форматируемой строке недостаточно редактируемых позиций для хранения содержимого замещающей строки.There are not enough editable positions in the formatted string to hold the contents of the replacement string.

  • Одно из значений символов замены недопустимо, так как оно не печатается или не соответствует соответствующему элементу Mask.One of the replacement character values is not valid because it is not printable or does not match its corresponding mask element.

Эта версия Set предоставляет два дополнительных выходных параметра для передачи дополнительных сведений о работе метода.This version of Set provides two additional output parameters to convey more information about the operation of the method.

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

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