Object.ToString Метод

Определение

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

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

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

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

Комментарии

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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