Exportieren (0) Drucken
Alle erweitern
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original

Object.ToString-Methode

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

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public virtual string ToString()

Rückgabewert

Typ: System.String
Eine Zeichenfolge, die das aktuelle Objekt darstellt.

ToString ist die Hauptformatierungsmethode in .NET Framework. Ein Objekt wird in seine Zeichenfolgendarstellung konvertiert, damit es für die Anzeige geeignet ist. (Weitere Informationen zur Unterstützung von Formatierung in .NET Framework finden Sie unter Formatierung von Typen.)

Die Standardimplementierung der ToString-Methode gibt den vollqualifizierten Namen des Typs vom Object zurück, wie das folgende Beispiel zeigt.


using System;

public class Example
{
   public static void Main()
   {
      Object obj = new Object();
      Console.WriteLine(obj.ToString());
   }
}
// The example displays the following output:
//      System.Object


Da Object die Basisklasse aller Verweistypen in .NET Framework ist, wird dieses Verhalten von Verweistypen geerbt, die die ToString-Methode nicht überschreiben. Dies wird anhand des folgenden Beispiels veranschaulicht: Eine Klasse mit dem Namen Object1 wird definiert, die die Standardimplementierung aller Object-Member akzeptiert. Die ToString-Methode gibt den vollqualifizierten Typnamen des Objekts zurück.


using System;
using Examples;

namespace Examples
{
   public class Object1
   {
   }
}

public class Example
{
   public static void Main()
   {
      object obj1 = new Object1();
      Console.WriteLine(obj1.ToString());
   }
}
// The example displays the following output:
//   Examples.Object1


Typen überschreiben im Allgemeinen die ToString-Methode, um eine Zeichenfolge zurückzugeben, die die Objektinstanz darstellt. Die Basisdatentypen wie Char implementieren z. B. Int32, und String stellen ToString-Implementierungen bereit, die die Zeichenfolgenform des Werts zurückgeben, den das Objekt darstellt. Im folgenden Beispiel wird die Klasse Object2 definiert, die die ToString-Methode überschreibt, um den Typnamen zusammen mit seinem Wert zurückzugeben.


using System;

public class Object2
{
   private object value;

   public Object2(object value)
   {
      this.value = value;
   }

   public override string ToString()
   {
      return base.ToString() + ": " + value.ToString();
   }
}

public class Example
{
   public static void Main()
   {
      Object2 obj2 = new Object2('a');
      Console.WriteLine(obj2.ToString());
   }
}
// The example displays the following output:
//       Object2: a


Hinweise zur Implementierung

Wenn Sie eigene 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 Formatierung erfordern, als ToString bereitstellt, können die IFormattable-Schnittstelle implementieren. Die IFormattable.ToString(String, IFormatProvider)-Methode ermöglicht es Ihnen, Formatzeichenfolgen zu definieren, die Formatierung steuern, und ein IFormatProvider-Objekt zu verwenden, das kulturspezifische Formatierung bereitstellen kann.

.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Unterstützt in:

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Datum

Versionsgeschichte

Grund

März 2011

Gründlich überarbeitet.

Kundenfeedback.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft