MaskedTextProvider.ToString Метод

Определение

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

System.ComponentModel

Сборка:

System.ComponentModel.TypeConverter.dll

Возвращает форматируемую строку.

Перегрузки

ToString(Boolean, Boolean, Boolean, Int32, Int32)	Возвращает подстроку форматируемой строки, при необходимости включая знаки приглашения, литералы и знаки пароля.
ToString(Boolean, Boolean, Int32, Int32)	Возвращает подстроку форматируемой строки, при необходимости включая знаки приглашения и литералы.
ToString(Boolean, Int32, Int32)	Возвращает подстроку форматируемой строки, при необходимости содержащую знаки пароля.
ToString(Boolean)	Возвращает форматируемую строку, при необходимости содержащую знаки пароля.
ToString(Boolean, Boolean)	Возвращает форматируемую строку, при необходимости включая знаки приглашения и литералы.
ToString()	Возвращает форматируемую строку, содержащую назначенные значения знаков.
ToString(Int32, Int32)	Возвращает подстроку форматируемой строки.

ToString(Boolean, Boolean, Boolean, Int32, Int32)

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

MaskedTextProvider.cs

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

public:
 System::String ^ ToString(bool ignorePasswordChar, bool includePrompt, bool includeLiterals, int startPosition, int length);

public string ToString (bool ignorePasswordChar, bool includePrompt, bool includeLiterals, int startPosition, int length);

override this.ToString : bool * bool * bool * int * int -> string

Public Function ToString (ignorePasswordChar As Boolean, includePrompt As Boolean, includeLiterals As Boolean, startPosition As Integer, length As Integer) As String

Параметры

ignorePasswordChar

Boolean

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

includePrompt

Boolean

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

includeLiterals

Boolean

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

startPosition

Int32

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

length

Int32

Число возвращаемых символов.

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

String

В случае успеха подстрока форматируемой строки String, содержащая все назначенные значения знаков и, при необходимости, литералы, знаки приглашения и знаки пароля; в противном случае — строка Empty.

Комментарии

Эта версия перегруженного ToString метода возвращает подстроку форматируемой строки, начиная с позиции startPos и включая последующее количество символов, указанное параметром length . Возвращаемая строка содержит запросы и литералы в соответствии со значениями IncludePrompt параметров и IncludeLiterals соответственно. Обратите внимание, что эти параметры переопределяют значения IncludePrompt свойств и IncludeLiterals . ignorePasswordChar Если параметр имеет значение true, он вернет исходные входные символы, игнорируя значение PasswordChar свойства . Если этот параметр имеет значение false, он будет использовать символ пароля, чтобы скрыть редактируемые данные пользователя, если свойству PasswordChar присвоено значение, отличное от null.

Важно!

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

ToString при несоответствии входных параметров выполняет следующие действия:

• Если startPos значение меньше нуля, начальная позиция устанавливается равным нулю.

• Если startPos значение больше или равно фактическому значению Length форматируемой строки, Empty возвращается строка.

• Если length значение больше, чем оставшееся число символов после начальной позиции, возвращаются только оставшиеся символы.

• Если length значение меньше или равно нулю, Empty возвращается строка.

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

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString(Boolean, Boolean, Int32, Int32)

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

MaskedTextProvider.cs

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

public:
 System::String ^ ToString(bool includePrompt, bool includeLiterals, int startPosition, int length);

public string ToString (bool includePrompt, bool includeLiterals, int startPosition, int length);

override this.ToString : bool * bool * int * int -> string

Public Function ToString (includePrompt As Boolean, includeLiterals As Boolean, startPosition As Integer, length As Integer) As String

Параметры

includePrompt

Boolean

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

includeLiterals

Boolean

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

startPosition

Int32

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

length

Int32

Число возвращаемых символов.

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

String

В случае успеха подстрока форматируемой строки String, содержащая все назначенные значения знаков и, при необходимости, литералы и приглашения; в противном случае — строка Empty.

Комментарии

Эта версия перегруженного ToString метода возвращает подстроку форматируемой строки, начиная с позиции startPos и включая последующее количество символов, указанное параметром length . Возвращаемая строка содержит запросы и литералы в соответствии со значениями IncludePrompt параметров и IncludeLiterals соответственно. Обратите внимание, что эти параметры переопределяют значения IncludePromptIncludeLiterals свойств . Этот метод всегда возвращает исходные входные символы, игнорируя значение PasswordChar свойства .

Важно!

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

ToString при несоответствии входных параметров выполняет следующие действия:

• Если startPos значение меньше нуля, начальная позиция устанавливается равным нулю.

• Если startPos значение больше или равно фактическому значению Length форматируемой строки, Empty возвращается строка.

• Если length значение больше, чем оставшееся число символов после начальной позиции, возвращаются только оставшиеся символы.

• Если length значение меньше или равно нулю, Empty возвращается строка.

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

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString(Boolean, Int32, Int32)

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

MaskedTextProvider.cs

Возвращает подстроку форматируемой строки, при необходимости содержащую знаки пароля.

public:
 System::String ^ ToString(bool ignorePasswordChar, int startPosition, int length);

public string ToString (bool ignorePasswordChar, int startPosition, int length);

override this.ToString : bool * int * int -> string

Public Function ToString (ignorePasswordChar As Boolean, startPosition As Integer, length As Integer) As String

Параметры

ignorePasswordChar

Boolean

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

startPosition

Int32

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

length

Int32

Число возвращаемых символов.

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

String

В случае успеха подстрока форматируемой строки String, содержащая литералы, приглашения и, при необходимости, знаки пароля; в противном случае — строка Empty.

Комментарии

Эта версия перегруженного ToString метода возвращает подстроку форматируемой строки, начиная с позиции startPos и включая последующее количество символов, указанное параметром length . Возвращаемая строка содержит запросы и литералы в соответствии с текущими значениями IncludePrompt свойств и IncludeLiterals соответственно. ignorePasswordChar Если параметр имеет значение true, он вернет исходные входные символы, игнорируя значение PasswordChar свойства . Если этот параметр имеет значение false, он будет использовать символ пароля, чтобы скрыть редактируемые данные пользователя, если свойству PasswordChar присвоено значение, отличное от null.

Важно!

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

ToString при несоответствии входных параметров выполняет следующие действия:

• Если startPos значение меньше нуля, начальная позиция устанавливается равным нулю.

• Если startPos значение больше или равно фактическому значению Length форматируемой строки, Empty возвращается строка.

• Если length значение больше, чем оставшееся число символов после начальной позиции, возвращаются только оставшиеся символы.

• Если length значение меньше или равно нулю, Empty возвращается строка.

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

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString(Boolean)

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

MaskedTextProvider.cs

Возвращает форматируемую строку, при необходимости содержащую знаки пароля.

public:
 System::String ^ ToString(bool ignorePasswordChar);

public string ToString (bool ignorePasswordChar);

override this.ToString : bool -> string

Public Function ToString (ignorePasswordChar As Boolean) As String

Параметры

ignorePasswordChar

Boolean

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

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

String

Форматируемая строка String, содержащая литералы, приглашения и, при необходимости, знаки пароля.

Комментарии

Эта версия перегруженного ToString метода включает запросы и литералы в соответствии с текущими значениями IncludePrompt свойств и IncludeLiterals соответственно. ignorePasswordChar Если параметр имеет значение true, он вернет исходные входные символы, игнорируя значение PasswordChar свойства . Если этот параметр имеет значение false, он будет использовать символ пароля, чтобы скрыть редактируемые данные пользователя, если свойству PasswordChar присвоено значение, отличное от null.

Важно!

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

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

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString(Boolean, Boolean)

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

MaskedTextProvider.cs

Возвращает форматируемую строку, при необходимости включая знаки приглашения и литералы.

public:
 System::String ^ ToString(bool includePrompt, bool includeLiterals);

public string ToString (bool includePrompt, bool includeLiterals);

override this.ToString : bool * bool -> string

Public Function ToString (includePrompt As Boolean, includeLiterals As Boolean) As String

Параметры

includePrompt

Boolean

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

includeLiterals

Boolean

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

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

String

Форматируемая строка String, содержащая все назначенные значения знаков и, при необходимости, литералы и приглашения.

Комментарии

Эта версия перегруженного ToString метода включает запросы и литералы в соответствии со значениями IncludePrompt параметров и IncludeLiterals соответственно. Обратите внимание, что эти параметры переопределяют значения IncludePromptIncludeLiterals свойств . Этот метод всегда возвращает исходные входные символы, игнорируя значение PasswordChar свойства .

Важно!

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

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

• IsAvailablePosition(Int32)
• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString()

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

MaskedTextProvider.cs

Возвращает форматируемую строку, содержащую назначенные значения знаков.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

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

String

Форматируемая строка String, содержащая все назначенные значения знаков.

Комментарии

Эта версия перегруженного ToString метода включает запросы и литералы в соответствии с текущими значениями IncludePrompt свойств и IncludeLiterals соответственно. Он всегда будет возвращать исходные входные символы, игнорируя значение PasswordChar свойства .

Важно!

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

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

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar

ToString(Int32, Int32)

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

MaskedTextProvider.cs

Возвращает подстроку форматируемой строки.

public:
 System::String ^ ToString(int startPosition, int length);

public string ToString (int startPosition, int length);

override this.ToString : int * int -> string

Public Function ToString (startPosition As Integer, length As Integer) As String

Параметры

startPosition

Int32

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

length

Int32

Число возвращаемых символов.

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

String

В случае успеха подстрока форматируемой строки String, содержащая все назначенные значения знаков; в противном случае — строка Empty.

Комментарии

Эта версия перегруженного ToString метода возвращает подстроку форматируемой строки, начиная с позиции startPos и включая последующее количество символов, указанное параметром length . Возвращаемая строка содержит запросы и литералы в соответствии с текущими значениями IncludePrompt свойств и IncludeLiterals соответственно. Возвращаемая строка будет содержать исходные входные символы; PasswordChar свойство всегда игнорируется.

Важно!

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

ToString при наличии несоответствий во входных параметрах выполняет следующие действия:

• Если startPos меньше нуля, начальная позиция устанавливается равным нулю.

• Если startPos значение больше или равно фактическому значению Length форматируемой строки, Empty возвращается строка.

• Если length значение больше, чем оставшееся число символов после начальной позиции, возвращаются только оставшиеся символы.

• Если length значение меньше или равно нулю, Empty возвращается строка.

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

• ToDisplayString()
• Set
• IncludePrompt
• IncludeLiterals
• PasswordChar