Compartilhar via


MaskedTextProvider.ToString Método

Definição

Retorna a cadeia de caracteres formatada.

Sobrecargas

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

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

ToString(Boolean, Boolean, Int32, Int32)

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

ToString(Boolean, Int32, Int32)

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

ToString(Boolean)

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

ToString(Boolean, Boolean)

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

ToString()

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

ToString(Int32, Int32)

Retorna uma subcadeia da cadeia de caracteres formatada.

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

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

Retorna uma subcadeia da cadeia de caracteres formatada, incluindo, opcionalmente, caracteres de prompt, de literais e de 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 propriedade PasswordChar 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 na qual começa a saída.

length
Int32

O número de caracteres a ser retornado.

Retornos

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

Comentários

Esta versão do método sobrecarregado retorna uma subcadeia ToString 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 IncludePrompt parâmetros e IncludeLiterals , respectivamente. Observe que esses parâmetros substituem os valores das IncludePrompt propriedades e IncludeLiterals . 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 de 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

Aplica-se a

ToString(Boolean, Boolean, Int32, Int32)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

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

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 na qual começa a saída.

length
Int32

O número de caracteres a ser retornado.

Retornos

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

Comentários

Esta versão do método sobrecarregado retorna uma subcadeia ToString 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 IncludePrompt parâmetros e IncludeLiterals , 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 revelar acidentalmente 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

Aplica-se a

ToString(Boolean, Int32, Int32)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

Retorna uma subcadeia 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 propriedade PasswordChar deve ser respeitada.

startPosition
Int32

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

length
Int32

O número de caracteres a ser retornado.

Retornos

Se for bem-sucedido, uma subcadeia da String formatada, que inclui literais, prompts e, opcionalmente, caracteres de senha; caso contrário, a cadeia de caracteres Empty.

Comentários

Esta versão do método sobrecarregado retorna uma subcadeia ToString 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 das IncludePrompt propriedades e IncludeLiterals , 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 de 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

Aplica-se a

ToString(Boolean)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

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

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 propriedade PasswordChar deve ser respeitada.

Retornos

A String formatada 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 das IncludePrompt propriedades e IncludeLiterals , 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 de 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

Aplica-se a

ToString(Boolean, Boolean)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

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

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

A String formatada 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 IncludePrompt parâmetros e IncludeLiterals , 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 revelar acidentalmente dados confidenciais do usuário.

Confira também

Aplica-se a

ToString()

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
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

A String formatada 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 das IncludePrompt propriedades e IncludeLiterals , 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 revelar acidentalmente dados confidenciais do usuário.

Confira também

Aplica-se a

ToString(Int32, Int32)

Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs
Origem:
MaskedTextProvider.cs

Retorna uma subcadeia 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 na qual começa a saída.

length
Int32

O número de caracteres a ser retornado.

Retornos

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

Comentários

Esta versão do método sobrecarregado retorna uma subcadeia ToString 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 das IncludePrompt propriedades e IncludeLiterals , 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 revelar acidentalmente 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

Aplica-se a