MaskedTextProvider.ToString Метод

Определение

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

Перегрузки

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

Возвращает подстроку форматируемой строки, при необходимости включая знаки приглашения, литералы и знаки пароля.Returns a substring of the formatted string, optionally including prompt, literal, and password characters.

ToString(Boolean, Boolean, Int32, Int32)

Возвращает подстроку форматируемой строки, при необходимости включая знаки приглашения и литералы.Returns a substring of the formatted string, optionally including prompt and literal characters.

ToString(Boolean, Int32, Int32)

Возвращает подстроку форматируемой строки, при необходимости содержащую знаки пароля.Returns a substring of the formatted string, optionally including password characters.

ToString(Boolean)

Возвращает форматируемую строку, при необходимости содержащую знаки пароля.Returns the formatted string, optionally including password characters.

ToString(Boolean, Boolean)

Возвращает форматируемую строку, при необходимости включая знаки приглашения и литералы.Returns the formatted string, optionally including prompt and literal characters.

ToString()

Возвращает форматируемую строку, содержащую назначенные значения знаков.Returns the formatted string that includes all the assigned character values.

ToString(Int32, Int32)

Возвращает подстроку форматируемой строки.Returns a substring of the formatted string.

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

Возвращает подстроку форматируемой строки, при необходимости включая знаки приглашения, литералы и знаки пароля.Returns a substring of the formatted string, optionally including prompt, literal, and password characters.

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.true to return the actual editable characters; otherwise, false to indicate that the PasswordChar property is to be honored.

includePrompt
Boolean

Значение true, чтобы включить знаки приглашения в возвращаемую строку; в противном случае — значение false.true to include prompt characters in the return string; otherwise, false.

includeLiterals
Boolean

Значение true, чтобы возвратить литералы в возвращенной строке; в противном случае — значение false.true to return literal characters in the return string; otherwise, false.

startPosition
Int32

Отсчитываемая от нуля позиция в форматируемой строке, с которой начинается вывод.The zero-based position in the formatted string where the output begins.

length
Int32

Число возвращаемых знаков.The number of characters to return.

Возвраты

В случае успеха подстрока форматируемой строки String, содержащая все назначенные значения знаков и, при необходимости, литералы, знаки приглашения и знаки пароля; в противном случае — строка Empty.If successful, a substring of the formatted String, which includes all the assigned character values and optionally includes literals, prompts, and password characters; otherwise the Empty string.

Комментарии

Эта версия перегруженного ToString метода возвращает подстроку форматируемой строки, начиная с позиции startPos и включая последующие числа символов, указанных в length параметре.This version of the overloaded ToString method returns a substring of the formatted string, starting at the position startPos and including the subsequent number of characters specified by the length parameter. Возвращаемая строка включает приглашения и литералы в соответствии со значениями IncludePrompt параметров и IncludeLiterals соответственно.The return string includes prompts and literals according to the values of the IncludePrompt and IncludeLiterals parameters, respectively. Обратите внимание, что эти параметры переопределяют IncludePrompt значения IncludeLiterals свойств и.Notice that these parameters override the values of the IncludePrompt and IncludeLiterals properties. Если параметр равен true, он возвращает исходные входные символы, игнорируя значение PasswordChar свойства. ignorePasswordCharIf the ignorePasswordChar parameter is true, it will return the original input characters, ignoring the value of the PasswordChar property. Если этот параметр имеет falseзначение, то он будет использовать символ пароля для скрытия редактируемого пользовательского ввода PasswordChar , если для свойства задано отличное от null.If this parameter is false, it will use the password character to obscure editable user input if the PasswordChar property is set to a value other than null.

Важно!

Поскольку этот метод потенциально раскрывает сведения, которые обычно защищаются в пользовательском интерфейсе символами пароля, его следует использовать с особой осторожностью, чтобы избежать случайного раскрытия конфиденциальных данных пользователя.Because this method potentially reveals information that is usually protected in the user interface by password characters, it should be used with extreme caution to avoid accidentally revealing sensitive user data.

ToStringвыполняет следующие действия при обнаружении расхождений во входных параметрах:ToString performs the following actions when there are discrepancies in the input parameters:

  • Если startPos значение меньше нуля, начальная координата устанавливается в ноль.If startPos is less than zero, the starting position is set to zero.

  • Если startPos значение параметра больше или равно фактическому Length значению форматируемой строки, Empty возвращается строка.If startPos is greater than or equal to the actual Length of the formatted string, the Empty string is returned.

  • Если length значение больше оставшегося числа символов после начальной позиции, возвращаются только оставшиеся символы.If length is greater than the remaining number of characters past the starting position, only the remaining characters are returned.

  • Если length значение меньше или равно нулю Empty , возвращается строка.If length is less than or equal to zero, the Empty string is returned.

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

ToString(Boolean, Boolean, Int32, Int32)

Возвращает подстроку форматируемой строки, при необходимости включая знаки приглашения и литералы.Returns a substring of the formatted string, optionally including prompt and literal characters.

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.true to include prompt characters in the return string; otherwise, false.

includeLiterals
Boolean

Значение true, чтобы включить литералы в возвращаемую строку; в противном случае — значение false.true to include literal characters in the return string; otherwise, false.

startPosition
Int32

Отсчитываемая от нуля позиция в форматируемой строке, с которой начинается вывод.The zero-based position in the formatted string where the output begins.

length
Int32

Число возвращаемых знаков.The number of characters to return.

Возвраты

В случае успеха подстрока форматируемой строки String, содержащая все назначенные значения знаков и, при необходимости, литералы и приглашения; в противном случае — строка Empty.If successful, a substring of the formatted String, which includes all the assigned character values and optionally includes literals and prompts; otherwise the Empty string.

Комментарии

Эта версия перегруженного ToString метода возвращает подстроку форматируемой строки, начиная с позиции startPos и включая последующие числа символов, указанных в length параметре.This version of the overloaded ToString method returns a substring of the formatted string, starting at the position startPos and including the subsequent number of characters specified by the length parameter. Возвращаемая строка включает приглашения и литералы в соответствии со значениями IncludePrompt параметров и IncludeLiterals соответственно.The return string includes prompts and literals according to the values of the IncludePrompt and IncludeLiterals parameters, respectively. Обратите внимание, что эти параметры переопределяют IncludePrompt значения IncludeLiterals свойств.Notice that these parameters override the values of the IncludePromptIncludeLiterals properties. Этот метод всегда будет возвращать исходные входные символы, игнорируя значение PasswordChar свойства.This method will always return the original input characters, ignoring the value of the PasswordChar property.

Важно!

Поскольку этот метод раскрывает сведения, которые обычно защищаются в пользовательском интерфейсе символами пароля, следует использовать с особой осторожностью, чтобы избежать случайного раскрытия конфиденциальных данных пользователя.Because this method reveals information that is usually protected in the user interface by password characters, it should be used with extreme caution to avoid accidentally revealing sensitive user data.

ToStringвыполняет следующие действия при обнаружении расхождений во входных параметрах:ToString performs the following actions when there are discrepancies in the input parameters:

  • Если startPos значение меньше нуля, начальная координата устанавливается в ноль.If startPos is less than zero, the starting position is set to zero.

  • Если startPos значение параметра больше или равно фактическому Length значению форматируемой строки, Empty возвращается строка.If startPos is greater than or equal to the actual Length of the formatted string, the Empty string is returned.

  • Если length значение больше оставшегося числа символов после начальной позиции, возвращаются только оставшиеся символы.If length is greater than the remaining number of characters past the starting position, only the remaining characters are returned.

  • Если length значение меньше или равно нулю Empty , возвращается строка.If length is less than or equal to zero, the Empty string is returned.

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

ToString(Boolean, Int32, Int32)

Возвращает подстроку форматируемой строки, при необходимости содержащую знаки пароля.Returns a substring of the formatted string, optionally including password characters.

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.true to return the actual editable characters; otherwise, false to indicate that the PasswordChar property is to be honored.

startPosition
Int32

Отсчитываемая от нуля позиция в форматируемой строке, с которой начинается вывод.The zero-based position in the formatted string where the output begins.

length
Int32

Число возвращаемых знаков.The number of characters to return.

Возвраты

В случае успеха подстрока форматируемой строки String, содержащая литералы, приглашения и, при необходимости, знаки пароля; в противном случае — строка Empty.If successful, a substring of the formatted String, which includes literals, prompts, and optionally password characters; otherwise the Empty string.

Комментарии

Эта версия перегруженного ToString метода возвращает подстроку форматируемой строки, начиная с позиции startPos и включая последующие числа символов, указанных в length параметре.This version of the overloaded ToString method returns a substring of the formatted string, starting at the position startPos and including the subsequent number of characters specified by the length parameter. Возвращаемая строка включает приглашения и литералы в соответствии с текущими значениями IncludePrompt свойств и IncludeLiterals соответственно.The returned string includes prompts and literals according to the current values of the IncludePrompt and IncludeLiterals properties, respectively. Если параметр равен true, он возвращает исходные входные символы, игнорируя значение PasswordChar свойства. ignorePasswordCharIf the ignorePasswordChar parameter is true, it will return the original input characters, ignoring the value of the PasswordChar property. Если этот параметр имеет falseзначение, то он будет использовать символ пароля для скрытия редактируемого пользовательского ввода PasswordChar , если для свойства задано отличное от null.If this parameter is false, it will use the password character to obscure editable user input if the PasswordChar property is set to a value other than null.

Важно!

Поскольку этот метод потенциально раскрывает сведения, которые обычно защищаются в пользовательском интерфейсе символами пароля, его следует использовать с особой осторожностью, чтобы избежать случайного раскрытия конфиденциальных данных пользователя.Because this method potentially reveals information that is usually protected in the user interface by password characters, it should be used with extreme caution to avoid accidentally revealing sensitive user data.

ToStringвыполняет следующие действия при обнаружении расхождений во входных параметрах:ToString performs the following actions when there are discrepancies in the input parameters:

  • Если startPos значение меньше нуля, начальная координата устанавливается в ноль.If startPos is less than zero, the starting position is set to zero.

  • Если startPos значение параметра больше или равно фактическому Length значению форматируемой строки, Empty возвращается строка.If startPos is greater than or equal to the actual Length of the formatted string, the Empty string is returned.

  • Если length значение больше оставшегося числа символов после начальной позиции, возвращаются только оставшиеся символы.If length is greater than the remaining number of characters past the starting position, only the remaining characters are returned.

  • Если length значение меньше или равно нулю Empty , возвращается строка.If length is less than or equal to zero, the Empty string is returned.

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

ToString(Boolean)

Возвращает форматируемую строку, при необходимости содержащую знаки пароля.Returns the formatted string, optionally including password characters.

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.true to return the actual editable characters; otherwise, false to indicate that the PasswordChar property is to be honored.

Возвраты

Форматируемая строка String, содержащая литералы, приглашения и, при необходимости, знаки пароля.The formatted String that includes literals, prompts, and optionally password characters.

Комментарии

Эта версия перегруженного ToString метода включает запросы и литералы в соответствии с текущими значениями IncludePrompt свойств и IncludeLiterals соответственно.This version of the overloaded ToString method includes prompts and literals according to the current values of the IncludePrompt and IncludeLiterals properties, respectively. Если параметр равен true, он возвращает исходные входные символы, игнорируя значение PasswordChar свойства. ignorePasswordCharIf the ignorePasswordChar parameter is true, it will return the original input characters, ignoring the value of the PasswordChar property. Если этот параметр имеет falseзначение, то он будет использовать символ пароля для скрытия редактируемого пользовательского ввода PasswordChar , если для свойства задано отличное от null.If this parameter is false, it will use the password character to obscure editable user input if the PasswordChar property is set to a value other than null.

Важно!

Поскольку этот метод потенциально раскрывает сведения, которые обычно защищаются в пользовательском интерфейсе символами пароля, его следует использовать с особой осторожностью, чтобы избежать случайного раскрытия конфиденциальных данных пользователя.Because this method potentially reveals information that is usually protected in the user interface by password characters, it should be used with extreme caution to avoid accidentally revealing sensitive user data.

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

ToString(Boolean, Boolean)

Возвращает форматируемую строку, при необходимости включая знаки приглашения и литералы.Returns the formatted string, optionally including prompt and literal characters.

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.true to include prompt characters in the return string; otherwise, false.

includeLiterals
Boolean

Значение true, чтобы включить литералы в возвращаемую строку; в противном случае — значение false.true to include literal characters in the return string; otherwise, false.

Возвраты

Форматируемая строка String, содержащая все назначенные значения знаков и, при необходимости, литералы и приглашения.The formatted String that includes all the assigned character values and optionally includes literals and prompts.

Комментарии

Эта версия перегруженного ToString метода включает запросы и литералы в соответствии со значениями IncludePrompt параметров и IncludeLiterals соответственно.This version of the overloaded ToString method includes prompts and literals according to the values of the IncludePrompt and IncludeLiterals parameters, respectively. Обратите внимание, что эти параметры переопределяют IncludePrompt значения IncludeLiterals свойств.Notice that these parameters override the values of the IncludePromptIncludeLiterals properties. Этот метод всегда будет возвращать исходные входные символы, игнорируя значение PasswordChar свойства.This method will always return the original input characters, ignoring the value of the PasswordChar property.

Важно!

Поскольку этот метод раскрывает сведения, которые обычно защищаются в пользовательском интерфейсе символами пароля, следует использовать с особой осторожностью, чтобы избежать случайного раскрытия конфиденциальных данных пользователя.Because this method reveals information that is usually protected in the user interface by password characters, it should be used with extreme caution to avoid accidentally revealing sensitive user data.

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

ToString()

Возвращает форматируемую строку, содержащую назначенные значения знаков.Returns the formatted string that includes all the assigned character values.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Возвраты

Форматируемая строка String, содержащая все назначенные значения знаков.The formatted String that includes all the assigned character values.

Комментарии

Эта версия перегруженного ToString метода включает запросы и литералы в соответствии с текущими значениями IncludePrompt свойств и IncludeLiterals соответственно.This version of the overloaded ToString method includes prompts and literals according to the current values of the IncludePrompt and IncludeLiterals properties, respectively. Он всегда будет возвращать исходные входные символы, игнорируя значение PasswordChar свойства.It will always return the original input characters, ignoring the value of the PasswordChar property.

Важно!

Поскольку этот метод раскрывает сведения, которые обычно защищаются в пользовательском интерфейсе символами пароля, следует использовать с особой осторожностью, чтобы избежать случайного раскрытия конфиденциальных данных пользователя.Because this method reveals information that is usually protected in the user interface by password characters, it should be used with extreme caution to avoid accidentally revealing sensitive user data.

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

ToString(Int32, Int32)

Возвращает подстроку форматируемой строки.Returns a substring of the formatted string.

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

Отсчитываемая от нуля позиция в форматируемой строке, с которой начинается вывод.The zero-based position in the formatted string where the output begins.

length
Int32

Число возвращаемых знаков.The number of characters to return.

Возвраты

В случае успеха подстрока форматируемой строки String, содержащая все назначенные значения знаков; в противном случае — строка Empty.If successful, a substring of the formatted String, which includes all the assigned character values; otherwise the Empty string.

Комментарии

Эта версия перегруженного ToString метода возвращает подстроку форматируемой строки, начиная с позиции startPos и включая последующие числа символов, указанных в length параметре.This version of the overloaded ToString method returns a substring of the formatted string, starting at the position startPos and including the subsequent number of characters specified by the length parameter. Возвращаемая строка включает приглашения и литералы в соответствии с текущими значениями IncludePrompt свойств и IncludeLiterals соответственно.The returned string includes prompts and literals according to the current values of the IncludePrompt and IncludeLiterals properties, respectively. Возвращаемая строка будет содержать исходные входные символы. PasswordChar свойство всегда игнорируется.The return string will contain the original input characters; the PasswordChar property is always ignored.

Важно!

Поскольку этот метод раскрывает сведения, которые обычно защищаются в пользовательском интерфейсе символами пароля, следует использовать с особой осторожностью, чтобы избежать случайного раскрытия конфиденциальных данных пользователя.Because this method reveals information that is usually protected in the user interface by password characters, it should be used with extreme caution to avoid accidentally revealing sensitive user data.

ToStringвыполняет следующие действия при обнаружении расхождений во входных параметрах:ToString performs the following actions when there are discrepancies in the input parameters:

  • Если startPos значение меньше нуля, начальная координата устанавливается в ноль.If startPos is less than zero, the starting position is set to zero.

  • Если startPos значение параметра больше или равно фактическому Length значению форматируемой строки, Empty возвращается строка.If startPos is greater than or equal to the actual Length of the formatted string, the Empty string is returned.

  • Если length значение больше оставшегося числа символов после начальной позиции, возвращаются только оставшиеся символы.If length is greater than the remaining number of characters past the starting position, only the remaining characters are returned.

  • Если length значение меньше или равно нулю Empty , возвращается строка.If length is less than or equal to zero, the Empty string is returned.

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

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