Object.ToString Método

Definição

Retorna uma cadeia de caracteres que representa o objeto atual.

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

Retornos

Uma cadeia de caracteres que representa o objeto atual.

Comentários

Para obter mais informações sobre essa API, consulte Comentários da API complementar para Object.ToString.

Notas aos Herdeiros

Ao implementar seus próprios tipos, você deve substituir o ToString() método para retornar valores significativos para esses tipos. Classes derivadas que exigem mais controle sobre a formatação do que ToString() as fornecidas podem implementar a IFormattable interface . Seu ToString(String, IFormatProvider) método permite que você defina cadeias de caracteres de formato que controlam a formatação e usem um IFormatProvider objeto que pode fornecer formatação específica da cultura.

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

  • A cadeia de caracteres retornada deve ser amigável e legível por humanos.

  • A cadeia de caracteres retornada deve identificar exclusivamente o valor da instância do objeto.

  • A cadeia de caracteres retornada deve ser o mais curta possível para que seja adequada para exibição por um depurador.

  • Sua ToString() substituição não deve retornar Empty ou uma cadeia de caracteres nula.

  • Sua ToString() substituição não deve gerar uma exceção.

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

  • Se a cadeia de caracteres retornada incluir informações confidenciais, primeiro você deverá exigir uma permissão apropriada. Se a demanda for bem-sucedida, você poderá retornar as informações confidenciais; caso contrário, você deve retornar uma cadeia de caracteres que exclui as informações confidenciais.

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

  • Se o tipo implementar um método de análise (ou Parse método ou TryParse , um construtor ou algum outro método estático que instancie uma instância do tipo de uma cadeia de caracteres), você deve garantir que a cadeia de caracteres retornada pelo ToString() método possa ser convertida em uma instância de objeto.

Aplica-se a

Confira também