Teilen über

Object.ToString Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
Object.cs
Quelle:
Object.cs
Quelle:
Object.cs

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

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

Gibt zurück

String

Eine Zeichenfolge, die das aktuelle Objekt darstellt.

Hinweise

Weitere Informationen zu dieser API finden Sie unter Ergänzende API-Hinweise für Object.ToString.

Hinweise für Vererber

Wenn Sie Ihre eigenen Typen implementieren, sollten Sie die ToString() -Methode überschreiben, um Werte zurückzugeben, die für diese Typen aussagekräftig sind. Abgeleitete Klassen, die mehr Kontrolle über die Formatierung erfordern als ToString() bereitgestellt, können die IFormattable -Schnittstelle implementieren. Mit der - ToString(String, IFormatProvider) Methode können Sie Formatzeichenfolgen definieren, die die Formatierung steuern, und ein IFormatProvider -Objekt verwenden, das kulturspezifische Formatierungen bereitstellen kann.

Außerkraftsetzungen der ToString() -Methode sollten den folgenden Richtlinien folgen:

  • Die zurückgegebene Zeichenfolge sollte von Menschen benutzerfreundlich und lesbar sein.

  • Die zurückgegebene Zeichenfolge sollte den Wert des Objekts instance eindeutig identifizieren.

  • Die zurückgegebene Zeichenfolge sollte so kurz wie möglich sein, damit sie für die Anzeige durch einen Debugger geeignet ist.

  • Die ToString() Außerkraftsetzung sollte keine NULL-Zeichenfolge zurückgeben Empty .

  • Ihre ToString() Außerkraftsetzung sollte keine Ausnahme auslösen.

  • Wenn die Zeichenfolgendarstellung eines instance kulturabhängig ist oder auf verschiedene Arten formatiert werden kann, implementieren Sie die IFormattable -Schnittstelle.

  • Wenn die zurückgegebene Zeichenfolge vertrauliche Informationen enthält, sollten Sie zunächst eine entsprechende Berechtigung verlangen. Wenn die Anforderung erfolgreich ist, können Sie die vertraulichen Informationen zurückgeben. Andernfalls sollten Sie eine Zeichenfolge zurückgeben, die die vertraulichen Informationen ausschließt.

  • Ihre ToString() Außerkraftsetzung sollte keine erkennbaren Nebenwirkungen haben, um Komplikationen beim Debuggen zu vermeiden. Beispielsweise sollte ein Aufruf der ToString() -Methode den Wert von instance Feldern nicht ändern.

  • Wenn Ihr Typ eine Analysemethode (oder ParseTryParse -methode, einen Konstruktor oder eine andere statische Methode implementiert, die eine instance des Typs aus einer Zeichenfolge instanziiert), sollten Sie sicherstellen, dass die von der ToString() -Methode zurückgegebene Zeichenfolge in ein Objekt instance konvertiert werden kann.

Gilt für:

Weitere Informationen