Object.ToString Метод

Определение

Пространство имен:
System
Сборки:
mscorlib.dll, System.Runtime.dll
Сборки:
netstandard.dll, System.Runtime.dll
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
Object.cs
Исходный код:
Object.cs
Исходный код:
Object.cs
Исходный код:
Object.cs
Исходный код:
Object.cs

Возвращает строку, представляющую текущий объект.

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

Возвращаемое значение

String

Строка, представляющая текущий объект.

Комментарии

Дополнительные сведения об этом API см. в дополнительных примечаниях API для Object.ToString.

Примечания для тех, кто наследует этот метод

При реализации собственных типов следует переопределить ToString() метод для возврата значений, значимых для этих типов. Производные классы, требующие большего контроля над форматированием, чем ToString() предоставляет возможность реализовать IFormattable интерфейс. Его ToString(String, IFormatProvider) метод позволяет определять строки формата, которые управляют форматированием и использовать IFormatProvider объект, который может обеспечить форматирование, зависящее от языка и региональных параметров.

Переопределения ToString() метода должны соответствовать следующим рекомендациям:

  • Возвращаемая строка должна быть понятной и доступной для чтения людьми.

  • Возвращаемая строка должна однозначно определить значение экземпляра объекта.

  • Возвращаемая строка должна быть максимально короткой, чтобы она была подходит для отображения отладчиком.

  • Переопределение ToString() не должно возвращать Empty или пустую строку.

  • Переопределение ToString() не должно вызывать исключение.

  • Если строковое представление экземпляра учитывает язык и региональные параметры или может быть отформатировано несколькими способами, реализуйте IFormattable интерфейс.

  • Если возвращаемая строка содержит конфиденциальную информацию, необходимо сначала требовать соответствующее разрешение. Если запрос выполнен успешно, вы можете вернуть конфиденциальную информацию; в противном случае следует вернуть строку, которая исключает конфиденциальную информацию.

  • Переопределение ToString() не должно иметь наблюдаемых побочных эффектов, чтобы избежать осложнений в отладке. Например, вызов ToString() метода не должен изменять значение полей экземпляра.

  • Если тип реализует метод синтаксического анализа (или ParseTryParse метод, конструктор или другой статический метод, который создает экземпляр типа из строки), необходимо убедиться, что строка, возвращаемая ToString() методом, может быть преобразована в экземпляр объекта.

Применяется к

См. также раздел