Como: substituir o método ToString (guia de programação C#)

Cada classe ou struct no C# implicitamente herda o Object classe. Portanto, cada objeto no C# obtém o ToString método, que retorna uma representação de seqüência de caracteres desse objeto. Por exemplo, todas as variáveis do tipo int tem um ToString método, que permite retornar seu conteúdo como uma seqüência de caracteres:

int x = 42;
string strx = x.ToString();
Console.WriteLine(strx);
// Output:
// 42

Quando você criar uma personalizada, classe ou struct, você deve substituir o ToString método para fornecer informações sobre o tipo de código do cliente.

Para obter informações sobre como usar o formato de seqüências e outros tipos de formatação personalizada com o ToString método, consulte Tipos de formatação..

Observação de segurança
Quando você decide quais informações devem ser fornecidas por meio desse método, considere a possibilidade de se sua classe ou struct será nunca usada pelo código não confiável.Tenha cuidado para garantir que você não fornecer qualquer informação que pode ser explorada por código mal-intencionado.

Para substituir o método de ToString em sua classe ou struct

1. Declarar um ToStringo método com os seguintes modificadores e o tipo de retorno:

   public override string ToString(){}
   

2. Implemente o método para que ele retorne uma seqüência de caracteres.

   O exemplo a seguir retorna o nome da classe em juntamente com os dados específicos a uma instância particular da classe.

       class Person
       {
           public string Name { get; set; }
           public int Age { get; set; }
   
           public override string ToString()
           {
               return "Person: " + Name + " " + Age;
           }
       }
   
   

   Você pode teste o ToString método conforme mostrado no exemplo de código a seguir:

   Person person = new Person { Name = "John", Age = 12 };
   Console.WriteLine(person);
   // Output:
   // Person: John 12
   

Consulte também

Referência

Classes e estruturas (guia de programação do C#)

a seqüência de caracteres (C# Reference)

novo (C# Reference)

Substituir (referência de C#)

virtual (C# Reference)

IFormattable

Conceitos

Guia de programação do C#

Outros recursos

Seqüências de caracteres (guia de programação do C#)

Tipos de formatação.