Поделиться через


Практическое руководство. Переопределение метода ToString (Руководство по программированию на C#)

Каждый класс или структура в C# неявно наследует классу Object.Поэтому каждый объект в языке C# получает метод ToString, который возвращает строковое представление данного объекта.Например, все переменные типа int имеют метод ToString, который позволяет им возвращать содержимое этой переменной в виде строки:

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

При создании пользовательского класса или структуры необходимо переопределить метод ToString, чтобы передать информацию о типе клиентскому коду.

Дополнительные сведения об использовании строк форматирования и другие типы пользовательского форматирования с методом ToString см. в разделе Типы форматирования.

Примечание о безопасностиПримечание по безопасности

При принятии решения относительно того, какая информация должна будет предоставляться посредством этого метода, подумайте, будет ли создаваемый класс или структура когда-либо использоваться ненадежным кодом.Постарайтесь не предоставлять информацию, которая может быть использована вредоносным кодом.

Переопределение метода ToString в классе или структуре

  1. Объявите метод ToString со следующими модификаторами и типом возвращаемого значения:

    public override string ToString(){}
    
  2. Реализуйте этот метод таким образом, чтобы он возвращал строку.

    В приведенном ниже примере возвращается не только имя класса, но и специфические данные для конкретного экземпляра класса.

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

    Метод ToString можно проверить с помощью показанного ниже кода.

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

См. также

Ссылки

Классы и структуры (Руководство по программированию в C#)

string (Справочник по C#)

new (справочник по C#)

override (Справочник по C#)

virtual (Справочник по C#)

IFormattable

Основные понятия

Руководство по программированию на C#

Другие ресурсы

Строки (Руководство по программированию на C#)

Типы форматирования