MaskedTextProvider.ToString Método

Definição

Namespace:

System.ComponentModel

Assemblies:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Retorna a cadeia de caracteres formatada.

Sobrecargas

Nome	Description
ToString(Boolean, Boolean, Boolean, Int32, Int32)	Retorna uma subcadeia de caracteres da cadeia de caracteres formatada, incluindo opcionalmente caracteres de prompt, literal e senha.
ToString(Boolean, Boolean, Int32, Int32)	Retorna uma subcadeia de caracteres da cadeia de caracteres formatada, incluindo opcionalmente caracteres de prompt e literal.
ToString(Boolean, Int32, Int32)	Retorna uma subcadeia de caracteres da cadeia de caracteres formatada, incluindo opcionalmente caracteres de senha.
ToString(Boolean)	Retorna a cadeia de caracteres formatada, incluindo opcionalmente caracteres de senha.
ToString(Boolean, Boolean)	Retorna a cadeia de caracteres formatada, opcionalmente incluindo caracteres de prompt e literal.
ToString()	Retorna a cadeia de caracteres formatada que inclui todos os valores de caractere atribuídos.
ToString(Int32, Int32)	Retorna uma subcadeia de caracteres da cadeia de caracteres formatada.

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

Origem:

MaskedTextProvider.cs

Retorna uma subcadeia de caracteres da cadeia de caracteres formatada, incluindo opcionalmente caracteres de prompt, literal e senha.

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

Parâmetros

ignorePasswordChar

Boolean

true para retornar os caracteres editáveis reais; caso contrário, false para indicar que a PasswordChar propriedade deve ser respeitada.

includePrompt

Boolean

true para incluir caracteres de prompt na cadeia de caracteres de retorno; caso contrário, false.

includeLiterals

Boolean

true para retornar caracteres literais na cadeia de caracteres de retorno; caso contrário, false.

startPosition

Int32

A posição baseada em zero na cadeia de caracteres formatada em que a saída começa.

length

Int32

O número de caracteres a serem retornados.

Retornos

String

Se bem-sucedida, uma subcadeia de caracteres formatada String, que inclui todos os valores de caractere atribuídos e, opcionalmente, inclui literais, prompts e caracteres de senha; caso contrário, a Empty cadeia de caracteres.

Comentários

Esta versão do método sobrecarregado ToString retorna uma subcadeia de caracteres da cadeia de caracteres formatada, começando na posição startPos e incluindo o número subsequente de caracteres especificado pelo length parâmetro. A cadeia de caracteres de retorno inclui prompts e literais de acordo com os valores dos parâmetros e IncludeLiterals dos IncludePrompt parâmetros, respectivamente. Observe que esses parâmetros substituem os valores do e IncludeLiterals das IncludePrompt propriedades. Se o ignorePasswordChar parâmetro for true, ele retornará os caracteres de entrada originais, ignorando o valor da PasswordChar propriedade. Se esse parâmetro for false, ele usará o caractere de senha para obscurecer a entrada do usuário editável se a PasswordChar propriedade estiver definida como um valor diferente null.

Importante

Como esse método potencialmente revela informações que geralmente são protegidas na interface do usuário por caracteres de senha, ele deve ser usado com extrema cautela para evitar a revelação acidental de dados confidenciais do usuário.

ToString executa as seguintes ações quando há discrepâncias nos parâmetros de entrada:

• Se startPos for menor que zero, a posição inicial será definida como zero.

• Se startPos for maior ou igual ao real Length da cadeia de caracteres formatada, a Empty cadeia de caracteres será retornada.

• Se length for maior que o número restante de caracteres após a posição inicial, somente os caracteres restantes serão retornados.

• Se length for menor ou igual a zero, a Empty cadeia de caracteres será retornada.

Confira também

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

ToString(Boolean, Boolean, Int32, Int32)

Origem:

MaskedTextProvider.cs

Retorna uma subcadeia de caracteres da cadeia de caracteres formatada, incluindo opcionalmente caracteres de prompt e literal.

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

Parâmetros

includePrompt

Boolean

true para incluir caracteres de prompt na cadeia de caracteres de retorno; caso contrário, false.

includeLiterals

Boolean

true para incluir caracteres literais na cadeia de caracteres de retorno; caso contrário, false.

startPosition

Int32

A posição baseada em zero na cadeia de caracteres formatada em que a saída começa.

length

Int32

O número de caracteres a serem retornados.

Retornos

String

Se bem-sucedido, uma subcadeia de caracteres formatada String, que inclui todos os valores de caractere atribuídos e, opcionalmente, inclui literais e prompts; caso contrário, a Empty cadeia de caracteres.

Comentários

Esta versão do método sobrecarregado ToString retorna uma subcadeia de caracteres da cadeia de caracteres formatada, começando na posição startPos e incluindo o número subsequente de caracteres especificado pelo length parâmetro. A cadeia de caracteres de retorno inclui prompts e literais de acordo com os valores dos parâmetros e IncludeLiterals dos IncludePrompt parâmetros, respectivamente. Observe que esses parâmetros substituem os valores das IncludePromptIncludeLiterals propriedades. Esse método sempre retornará os caracteres de entrada originais, ignorando o valor da PasswordChar propriedade.

Importante

Como esse método revela informações que geralmente são protegidas na interface do usuário por caracteres de senha, ele deve ser usado com extrema cautela para evitar a revelação acidental de dados confidenciais do usuário.

ToString executa as seguintes ações quando há discrepâncias nos parâmetros de entrada:

• Se startPos for menor que zero, a posição inicial será definida como zero.

• Se startPos for maior ou igual ao real Length da cadeia de caracteres formatada, a Empty cadeia de caracteres será retornada.

• Se length for maior que o número restante de caracteres após a posição inicial, somente os caracteres restantes serão retornados.

• Se length for menor ou igual a zero, a Empty cadeia de caracteres será retornada.

Confira também

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

ToString(Boolean, Int32, Int32)

Origem:

MaskedTextProvider.cs

Retorna uma subcadeia de caracteres da cadeia de caracteres formatada, incluindo opcionalmente caracteres de senha.

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

Parâmetros

ignorePasswordChar

Boolean

true para retornar os caracteres editáveis reais; caso contrário, false para indicar que a PasswordChar propriedade deve ser respeitada.

startPosition

Int32

A posição baseada em zero na cadeia de caracteres formatada em que a saída começa.

length

Int32

O número de caracteres a serem retornados.

Retornos

String

Se tiver êxito, uma subcadeia de caracteres do formato String, que inclui literais, prompts e, opcionalmente, caracteres de senha; caso contrário, a Empty cadeia de caracteres.

Comentários

Esta versão do método sobrecarregado ToString retorna uma subcadeia de caracteres da cadeia de caracteres formatada, começando na posição startPos e incluindo o número subsequente de caracteres especificado pelo length parâmetro. A cadeia de caracteres retornada inclui prompts e literais de acordo com os valores atuais e as IncludePromptIncludeLiterals propriedades, respectivamente. Se o ignorePasswordChar parâmetro for true, ele retornará os caracteres de entrada originais, ignorando o valor da PasswordChar propriedade. Se esse parâmetro for false, ele usará o caractere de senha para obscurecer a entrada do usuário editável se a PasswordChar propriedade estiver definida como um valor diferente null.

Importante

Como esse método potencialmente revela informações que geralmente são protegidas na interface do usuário por caracteres de senha, ele deve ser usado com extrema cautela para evitar a revelação acidental de dados confidenciais do usuário.

ToString executa as seguintes ações quando há discrepâncias nos parâmetros de entrada:

• Se startPos for menor que zero, a posição inicial será definida como zero.

• Se startPos for maior ou igual ao real Length da cadeia de caracteres formatada, a Empty cadeia de caracteres será retornada.

• Se length for maior que o número restante de caracteres após a posição inicial, somente os caracteres restantes serão retornados.

• Se length for menor ou igual a zero, a Empty cadeia de caracteres será retornada.

Confira também

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

ToString(Boolean)

Origem:

MaskedTextProvider.cs

Retorna a cadeia de caracteres formatada, incluindo opcionalmente caracteres de senha.

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

public string ToString(bool ignorePasswordChar);

override this.ToString : bool -> string

Public Function ToString (ignorePasswordChar As Boolean) As String

Parâmetros

ignorePasswordChar

Boolean

true para retornar os caracteres editáveis reais; caso contrário, false para indicar que a PasswordChar propriedade deve ser respeitada.

Retornos

String

O formato String que inclui literais, prompts e, opcionalmente, caracteres de senha.

Comentários

Esta versão do método sobrecarregado ToString inclui prompts e literais de acordo com os valores atuais do e IncludeLiterals das IncludePrompt propriedades, respectivamente. Se o ignorePasswordChar parâmetro for true, ele retornará os caracteres de entrada originais, ignorando o valor da PasswordChar propriedade. Se esse parâmetro for false, ele usará o caractere de senha para obscurecer a entrada do usuário editável se a PasswordChar propriedade estiver definida como um valor diferente null.

Importante

Como esse método potencialmente revela informações que geralmente são protegidas na interface do usuário por caracteres de senha, ele deve ser usado com extrema cautela para evitar a revelação acidental de dados confidenciais do usuário.

Confira também

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

ToString(Boolean, Boolean)

Origem:

MaskedTextProvider.cs

Retorna a cadeia de caracteres formatada, opcionalmente incluindo caracteres de prompt e literal.

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

Parâmetros

includePrompt

Boolean

true para incluir caracteres de prompt na cadeia de caracteres de retorno; caso contrário, false.

includeLiterals

Boolean

true para incluir caracteres literais na cadeia de caracteres de retorno; caso contrário, false.

Retornos

String

O formatado String que inclui todos os valores de caractere atribuídos e, opcionalmente, inclui literais e prompts.

Comentários

Essa versão do método sobrecarregado ToString inclui prompts e literais de acordo com os valores dos parâmetros e IncludeLiterals dos IncludePrompt valores, respectivamente. Observe que esses parâmetros substituem os valores das IncludePromptIncludeLiterals propriedades. Esse método sempre retornará os caracteres de entrada originais, ignorando o valor da PasswordChar propriedade.

Importante

Como esse método revela informações que geralmente são protegidas na interface do usuário por caracteres de senha, ele deve ser usado com extrema cautela para evitar a revelação acidental de dados confidenciais do usuário.

Confira também

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

ToString()

Origem:

MaskedTextProvider.cs

Retorna a cadeia de caracteres formatada que inclui todos os valores de caractere atribuídos.

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

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retornos

String

O formatado String que inclui todos os valores de caractere atribuídos.

Comentários

Esta versão do método sobrecarregado ToString inclui prompts e literais de acordo com os valores atuais do e IncludeLiterals das IncludePrompt propriedades, respectivamente. Ele sempre retornará os caracteres de entrada originais, ignorando o valor da PasswordChar propriedade.

Importante

Como esse método revela informações que geralmente são protegidas na interface do usuário por caracteres de senha, ele deve ser usado com extrema cautela para evitar a revelação acidental de dados confidenciais do usuário.

Confira também

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

ToString(Int32, Int32)

Origem:

MaskedTextProvider.cs

Retorna uma subcadeia de caracteres da cadeia de caracteres formatada.

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

Parâmetros

startPosition

Int32

A posição baseada em zero na cadeia de caracteres formatada em que a saída começa.

length

Int32

O número de caracteres a serem retornados.

Retornos

String

Se tiver êxito, uma subcadeia de caracteres formatada String, que inclui todos os valores de caractere atribuídos; caso contrário, a Empty cadeia de caracteres.

Comentários

Esta versão do método sobrecarregado ToString retorna uma subcadeia de caracteres da cadeia de caracteres formatada, começando na posição startPos e incluindo o número subsequente de caracteres especificado pelo length parâmetro. A cadeia de caracteres retornada inclui prompts e literais de acordo com os valores atuais e as IncludePromptIncludeLiterals propriedades, respectivamente. A cadeia de caracteres de retorno conterá os caracteres de entrada originais; a PasswordChar propriedade é sempre ignorada.

Importante

Como esse método revela informações que geralmente são protegidas na interface do usuário por caracteres de senha, ele deve ser usado com extrema cautela para evitar a revelação acidental de dados confidenciais do usuário.

ToString executa as seguintes ações quando há discrepâncias nos parâmetros de entrada:

• Se startPos for menor que zero, a posição inicial será definida como zero.

• Se startPos for maior ou igual ao real Length da cadeia de caracteres formatada, a Empty cadeia de caracteres será retornada.

• Se length for maior que o número restante de caracteres após a posição inicial, somente os caracteres restantes serão retornados.

• Se length for menor ou igual a zero, a Empty cadeia de caracteres será retornada.

Confira também

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