MaskedTextProvider.ToString Método

Referência

Definição

Namespace:: System.ComponentModel

Assembly:: System.ComponentModel.TypeConverter.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

String

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

String

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 IncludePrompt IncludeLiterals 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

String

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

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

String

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

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

String

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 IncludePrompt IncludeLiterals propriedades. Esse método sempre retornará os caracteres de entrada originais, ignorando o valor da PasswordChar propriedade .

Importante

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

String

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

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

String

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

Importante

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

Compartilhar via

MaskedTextProvider.ToString Método

Definição

Sobrecargas

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

Parâmetros

Retornos

Comentários

Confira também

Aplica-se a

ToString(Boolean, Boolean, Int32, Int32)

Parâmetros

Retornos

Comentários

Confira também

Aplica-se a

ToString(Boolean, Int32, Int32)

Parâmetros

Retornos

Comentários

Confira também

Aplica-se a

ToString(Boolean)

Parâmetros

Retornos

Comentários

Confira também

Aplica-se a

ToString(Boolean, Boolean)

Parâmetros

Retornos

Comentários

Confira também

Aplica-se a

ToString()

Retornos

Comentários

Confira também

Aplica-se a

ToString(Int32, Int32)

Parâmetros

Retornos

Comentários

Confira também

Aplica-se a

Recursos adicionais