Object.ToString Método

Definição

Espaço de Nomes:
System
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
netstandard.dll

Devolve uma cadeia que representa o objeto atual.

public:
 virtual System::String ^ ToString();
public virtual string ToString();
abstract member ToString : unit -> string
override this.ToString : unit -> string
Public Overridable Function ToString () As String

Devoluções

String

Uma cadeia que representa o objeto atual.

Observações

Para mais informações sobre esta API, consulte Observações suplementares da API para Object.ToString.

Notas para Herdeiros

Quando implementas os teus próprios tipos, deves sobrescrever o ToString() método para devolver valores que sejam significativos para esses tipos. As classes derivadas que exigem mais controlo sobre a formatação do que as ToString() que fornecem podem implementar a IFormattable interface. O seu método permite-lhe definir strings de formato que controlam a formatação e usar um IFormatProvider objeto que pode fornecer formatação específica de ToString(String, IFormatProvider) cada cultura.

As sobreposições do ToString() método devem seguir estas diretrizes:

  • A sequência devolvida deve ser amigável e legível para humanos.

  • A cadeia devolvida deve identificar de forma única o valor da instância do objeto.

  • A string devolvida deve ser o mais curta possível para ser adequada para ser exibida por um depurador.

  • O teu ToString() override não deve regressar Empty nem uma cadeia nula.

  • O teu ToString() override não deve lançar uma exceção.

  • Se a representação das cadeias de uma instância for sensível à cultura ou puder ser formatada de várias formas, implemente a IFormattable interface.

  • Se a cadeia devolvida incluir informações sensíveis, deve primeiro exigir uma autorização adequada. Se a exigência for bem-sucedida, pode devolver a informação sensível; Caso contrário, deve devolver uma cadeia que exclua a informação sensível.

  • O seu ToString() override não deve ter efeitos secundários observáveis para evitar complicações na depuração. Por exemplo, uma chamada ao ToString() método não deve alterar o valor dos campos de instância.

  • Se o seu tipo implementa um método de análise sintática (ou Parse / TryParse ou método, um construtor, ou algum outro método estático que instancia uma instância do tipo a partir de uma cadeia), deve garantir que a cadeia devolvida pelo ToString() método pode ser convertida numa instância de objeto.

Aplica-se a

Ver também