Object.ToString Methode

Definition

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

Object.ToStringist die wichtigste Formatierungsmethode im .NET Framework. Ein Objekt wird in seine Zeichenfolgendarstellung konvertiert, sodass es für die Anzeige geeignet ist. (Informationen zur Formatierungsunterstützung im .NET Framework finden Sie unter Formatieren von Typen.) Standardimplementierungen der Object.ToString -Methode geben den vollqualifizierten Namen des Objekttyps zurück.

Wichtig

Möglicherweise haben Sie diese Seite erreicht, indem Sie dem Link aus der Memberliste eines anderen Typs folgen. Das liegt daran, dass dieser Typ nicht Object.ToString überschreibt. Stattdessen erbt er die Funktionalität der Object.ToString -Methode.

Typen überschreiben häufig die Object.ToString -Methode, um eine geeignetere Zeichenfolgendarstellung eines bestimmten Typs bereitzustellen. Typen überladen auch häufig die Object.ToString -Methode, um Unterstützung für Formatzeichenfolgen oder kulturabhängige Formatierung bereitzustellen.

In diesem Abschnitt

Die Object.ToString()-Standardmethode
Überschreiben der Object.ToString()-Methode
Überladen der ToString-Methode
Erweitern der Object.ToString-Methode
Hinweise zur Windows Runtime

Die Object.ToString()-Standardmethode

Die Standardimplementierung ToString der -Methode gibt den vollqualifizierten Namen des Typs von Object zurück, wie im folgenden Beispiel gezeigt.

using namespace System;

void main()
{
   Object^ obj = gcnew Object();
   Console::WriteLine(obj->ToString());
}
// The example displays the following output:
//      System.Object
Object obj = new Object();
Console.WriteLine(obj.ToString());

// The example displays the following output:
//      System.Object
Module Example
   Public Sub Main()
      Dim obj As New Object()
      Console.WriteLine(obj.ToString())
   End Sub
End Module
' The example displays the following output:
'      System.Object

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

using namespace System;

namespace Examples
{
   ref class Object1
   {
   };
}

void main()
{
   Object^ obj1 = gcnew Examples::Object1();
   Console::WriteLine(obj1->ToString());
}
// The example displays the following output:
//   Examples.Object1
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
Imports Examples

Namespace Examples
   Public Class Object1
   End Class
End Namespace

Module Example
   Public Sub Main()
      Dim obj1 As New Object1()
      Console.WriteLine(obj1.ToString())
   End Sub
End Module
' The example displays the following output:
'   Examples.Object1

Überschreiben der Object.ToString()-Methode

Typen überschreiben in der Regel Object.ToString die -Methode, um eine Zeichenfolge zurückgibt, die die Objektinstanz darstellt. Beispielsweise stellen die Basistypen wie , und Implementierungen zur Verfügung, die die Zeichenfolgenform des Werts zurückgeben, Char Int32 den das String ToString -Objekt darstellt. Im folgenden Beispiel wird die -Klasse definiert, die die -Methode überschreibt, um den Typnamen zusammen mit Object2 ihrem Wert zurück zu ToString geben.

using namespace System;

ref class Object2
{
   private:
      Object^ value;

   public:
      Object2(Object^ value)
      {
         this->value = value;
      }

      virtual String^ ToString() override
      {
         return Object::ToString() + ": " + value->ToString();
      }
};

void main()
{
   Object2^ obj2 = gcnew Object2(L'a');
   Console::WriteLine(obj2->ToString());
 
}
// The example displays the following output:
//       Object2: a
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
Public Class Object2
   Private value As Object
   
   Public Sub New(value As Object)
      Me.value = value
   End Sub
   
   Public Overrides Function ToString() As String
      Return MyBase.ToString + ": " + value.ToString()
   End Function
End Class

Module Example
   Public Sub Main()
      Dim obj2 As New Object2("a"c)
      Console.WriteLine(obj2.ToString())
   End Sub
End Module
' The example displays the following output:
'       Object2: a

Die folgende Tabelle listet die Typkategorien in .NET auf und gibt an, ob sie die -Methode Object.ToString überschreiben.

Typkategorie Überschreibt Object.ToString() Verhalten
Klasse
Struktur Ja ( ValueType.ToString ) Identisch mit Object.ToString()
Enumeration Ja ( Enum.ToString() ) Der Membername
Schnittstelle Nein
Delegat Nein

Weitere Informationen zum Überschreiben von finden Sie im Abschnitt Hinweise zu ToString Erben.

Überladen der ToString-Methode

Neben dem Überschreiben der parameterlosen Methode überladen viele Typen die -Methode, um Versionen der Methode zur Verfügung zu Object.ToString() stellen, ToString die Parameter akzeptieren. In den meisten Fall wird dies durchgeführt, um Unterstützung für die Formatierung von Variablen und kultursensible Formatierung zu bieten.

Im folgenden Beispiel wird die -Methode ToString überladen, um eine Ergebniszeichenfolge zurückgibt, die den Wert verschiedener Felder einer Klasse Automobile enthält. Sie definiert vier Formatzeichenfolgen: G, das den Modellnamen und das Jahr zurückgibt. D, das den Modellnamen, das Jahr und die Anzahl der Türen zurückgibt; C, das den Modellnamen, das Jahr und die Anzahl der Zylinder zurückgibt; und A, die eine Zeichenfolge mit allen vier Feldwerten zurückgibt.

using System;

public class Automobile
{
   private int _doors;
   private string _cylinders;
   private int _year;
   private string _model;

   public Automobile(string model, int year , int doors,
                     string cylinders)
   {
      _model = model;
      _year = year;
      _doors = doors;
      _cylinders = cylinders;
   }

   public int Doors
   { get { return _doors; } }

   public string Model
   { get { return _model; } }

   public int Year
   { get { return _year; } }

   public string Cylinders
   { get { return _cylinders; } }

   public override string ToString()
   {
      return ToString("G");
   }

   public string ToString(string fmt)
   {
      if (string.IsNullOrEmpty(fmt))
         fmt = "G";

      switch (fmt.ToUpperInvariant())
      {
         case "G":
            return string.Format("{0} {1}", _year, _model);
         case "D":
            return string.Format("{0} {1}, {2} dr.",
                                 _year, _model, _doors);
         case "C":
            return string.Format("{0} {1}, {2}",
                                 _year, _model, _cylinders);
         case "A":
            return string.Format("{0} {1}, {2} dr. {3}",
                                 _year, _model, _doors, _cylinders);
         default:
            string msg = string.Format("'{0}' is an invalid format string",
                                       fmt);
            throw new ArgumentException(msg);
      }
   }
}

public class Example
{
   public static void Main()
   {
      var auto = new Automobile("Lynx", 2016, 4, "V8");
      Console.WriteLine(auto.ToString());
      Console.WriteLine(auto.ToString("A"));
   }
}
// The example displays the following output:
//       2016 Lynx
//       2016 Lynx, 4 dr. V8
Public Class Automobile
   Private _doors As Integer
   Private _cylinders As String
   Private _year As Integer
   Private _model As String
   
   Public Sub New(model As String, year As Integer, doors As Integer,
                  cylinders As String)
      _model = model
      _year = year
      _doors = doors
      _cylinders = cylinders
   End Sub
   
   Public ReadOnly Property Doors As Integer
      Get
          Return _doors
      End Get
   End Property
   
   Public ReadOnly Property Model As String
      Get
         Return _model
      End Get
   End Property
   
   Public ReadOnly Property Year As Integer
      Get
         Return _year
      End Get
   End Property
   
   Public ReadOnly Property Cylinders As String
      Get
         Return _cylinders
      End Get
   End Property
   
   Public Overrides Function ToString() As String
      Return ToString("G")
   End Function
   
   Public Overloads Function ToString(fmt As String) As String
      If String.IsNullOrEmpty(fmt) Then fmt = "G"
      
      Select Case fmt.ToUpperInvariant()
         Case "G"
            Return String.Format("{0} {1}", _year, _model)
         Case "D"
            Return String.Format("{0} {1}, {2} dr.",
                                 _year, _model, _doors)
         Case "C"
            Return String.Format("{0} {1}, {2}",
                                 _year, _model, _cylinders)
         Case "A"
            Return String.Format("{0} {1}, {2} dr. {3}",
                                 _year, _model, _doors, _cylinders)
         Case Else
            Dim msg As String = String.Format("'{0}' is an invalid format string",
                                              fmt)
            Throw New ArgumentException(msg)
      End Select
   End Function
End Class

Module Example
   Public Sub Main()
      Dim auto As New Automobile("Lynx", 2016, 4, "V8")
      Console.WriteLine(auto.ToString())
      Console.WriteLine(auto.ToString("A"))
   End Sub
End Module
' The example displays the following output:
'       2016 Lynx
'       2016 Lynx, 4 dr. V8

Im folgenden Beispiel wird die überladene Decimal.ToString(String, IFormatProvider) -Methode zum Anzeigen kultursensibler Formatierungen eines Währungswerts aufruft.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] cultureNames = { "en-US", "en-GB", "fr-FR",
                                "hr-HR", "ja-JP" };
      Decimal value = 1603.49m;
      foreach (var cultureName in cultureNames) {
         CultureInfo culture = new CultureInfo(cultureName);
         Console.WriteLine("{0}: {1}", culture.Name,
                           value.ToString("C2", culture));
      }
   }
}
// The example displays the following output:
//       en-US: $1,603.49
//       en-GB: £1,603.49
//       fr-FR: 1 603,49 €
//       hr-HR: 1.603,49 kn
//       ja-JP: ¥1,603.49
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim cultureNames() As String = { "en-US", "en-GB", "fr-FR",
                                       "hr-HR", "ja-JP" }
      Dim value As Decimal = 1603.49d
      For Each cultureName In cultureNames
         Dim culture As New CultureInfo(cultureName)
         Console.WriteLine("{0}: {1}", culture.Name,
                           value.ToString("C2", culture))
      Next
   End Sub
End Module
' The example displays the following output:
'       en-US: $1,603.49
'       en-GB: £1,603.49
'       fr-FR: 1 603,49 €
'       hr-HR: 1.603,49 kn
'       ja-JP: ¥1,603.49

Weitere Informationen zu Formatzeichenfolgen und kultursensibler Formatierung finden Sie unter Formatieren von Typen. Informationen zu den Formatzeichenfolgen, die von numerischen Werten unterstützt werden, finden Sie unter Numerische Standardformatzeichenfolgen und Benutzerdefinierte numerische Formatzeichenfolgen. Informationen zu den Formatzeichenfolgen, die von Datums- und Uhrzeitwerten unterstützt werden, finden Sie unter Standardformatzeichenfolgen für Datum und Uhrzeit und Benutzerdefinierte Formatzeichenfolgenfür Datum und Uhrzeit.

Erweitern der Object.ToString-Methode

Da ein Typ die Standardmethode erbt, ist das Verhalten möglicherweise unerwünscht, Object.ToString und Sie möchten es ändern. Dies gilt insbesondere für Arrays und Auflistungsklassen. Obwohl Sie erwarten können, dass die -Methode eines Arrays oder einer Auflistungsklasse die Werte der Member anzeigt, wird stattdessen der vollqualifizierte Typname des Typs angezeigt, wie im folgenden ToString Beispiel gezeigt.

int[] values = { 1, 2, 4, 8, 16, 32, 64, 128 };
Console.WriteLine(values.ToString());

List<int> list = new List<int>(values);
Console.WriteLine(list.ToString());

// The example displays the following output:
//       System.Int32[]
//       System.Collections.Generic.List`1[System.Int32]
Imports System.Collections.Generic

Module Example
   Public Sub Main()
      Dim values() As Integer = { 1, 2, 4, 8, 16, 32, 64, 128 }
      Console.WriteLine(values.ToString())
      
      Dim list As New List(Of Integer)(values)
      Console.WriteLine(list.ToString())
   End Sub
End Module
' The example displays the following output:
'    System.Int32[]
'    System.Collections.Generic.List`1[System.Int32]

Sie haben mehrere Optionen, um die Ergebniszeichenfolge zu erzeugen, die Sie möchten.

  • Wenn der Typ ein Array, ein Auflistungsobjekt oder ein Objekt ist, das die Schnittstellen oder implementiert, können Sie seine Elemente aufzählen, indem Sie die -Anweisung in C# oder das -Konstrukt IEnumerable IEnumerable<T> in foreach C# For Each...Next Visual Basic.

  • Wenn die Klasse nicht (in C#) oder (in Visual Basic) ist, können Sie eine sealed Wrapperklasse entwickeln, die von der Basisklasse erbt, deren Methode NotInheritable Object.ToString Sie anpassen möchten. Dies erfordert mindestens Folgendes:

    1. Implementieren Sie alle erforderlichen Konstruktoren. Abgeleitete Klassen erben ihre Basisklassenkonstruktoren nicht.

    2. Überschreiben Sie Object.ToString die -Methode, um die ergebniszeichenfolge zurückgibt, die Sie möchten.

    Im folgenden Beispiel wird eine Wrapperklasse für die -Klasse List<T> definiert. Sie überschreibt die -Methode, um den Wert jeder Methode der Auflistung anstelle des vollqualifizierten Object.ToString Typnamens anzuzeigen.

    using System;
    using System.Collections.Generic;
    
    public class CList<T> : List<T>
    {
       public CList(IEnumerable<T> collection) : base(collection)
       { }
    
       public CList() : base()
       {}
    
       public override string ToString()
       {
          string retVal = string.Empty;
          foreach (T item in this) {
             if (string.IsNullOrEmpty(retVal))
                retVal += item.ToString();
             else
                retVal += string.Format(", {0}", item);
          }
          return retVal;
       }
    }
    
    public class Example
    {
       public static void Main()
       {
          var list2 = new CList<int>();
          list2.Add(1000);
          list2.Add(2000);
          Console.WriteLine(list2.ToString());
       }
    }
    // The example displays the following output:
    //    1000, 2000
    
    Imports System.Collections.Generic
    
    Public Class CList(Of T) : Inherits List(Of T)
       Public Sub New(capacity As Integer)
          MyBase.New(capacity)
       End Sub
    
       Public Sub New(collection As IEnumerable(Of T))
          MyBase.New(collection)
       End Sub
    
       Public Sub New()
          MyBase.New()
       End Sub
    
       Public Overrides Function ToString() As String
          Dim retVal As String = String.Empty
          For Each item As T In Me
             If String.IsNullOrEmpty(retval) Then
                retVal += item.ToString()
             Else
                retval += String.Format(", {0}", item)
             End If
          Next
          Return retVal
       End Function
    End Class
    
    Module Example
       Public Sub Main()
          Dim list2 As New CList(Of Integer)
          list2.Add(1000)
          list2.Add(2000)
          Console.WriteLine(list2.ToString())
       End Sub
    End Module
    ' The example displays the following output:
    '       1000, 2000
    
  • Entwickeln Sie eine Erweiterungsmethode, die die von Ihnen gestützte Ergebniszeichenfolge zurückgibt. Beachten Sie, dass Sie die Standardmethode nicht auf diese Weise überschreiben können (d. h. Ihre Erweiterungsklasse (in C#) oder Das Modul (in Visual Basic) kann keine parameterlose Methode namens haben, die statt der -Methode des ursprünglichen Typs aufgerufen Object.ToString ToString ToString wird. Sie müssen einen anderen Namen für Ihren parameterlosen Ersatz ToString angeben.

    Im folgenden Beispiel werden zwei Methoden definiert, die die -Klasse erweitern: eine parameterlose Methode und eine Methode mit einem List<T> ToString2 -Parameter, der eine ToString String Formatzeichenfolge darstellt.

    using System;
    using System.Collections.Generic;
    
    public static class StringExtensions
    {
       public static string ToString2<T>(this List<T> l)
       {
          string retVal = string.Empty;
          foreach (T item in l)
             retVal += string.Format("{0}{1}", string.IsNullOrEmpty(retVal) ?
                                                         "" : ", ",
                                      item);
          return string.IsNullOrEmpty(retVal) ? "{}" : "{ " + retVal + " }";
       }
    
       public static string ToString<T>(this List<T> l, string fmt)
       {
          string retVal = string.Empty;
          foreach (T item in l) {
             IFormattable ifmt = item as IFormattable;
             if (ifmt != null)
                retVal += string.Format("{0}{1}",
                                        string.IsNullOrEmpty(retVal) ?
                                           "" : ", ", ifmt.ToString(fmt, null));
             else
                retVal += ToString2(l);
          }
          return string.IsNullOrEmpty(retVal) ? "{}" : "{ " + retVal + " }";
       }
    }
    
    public class Example
    {
       public static void Main()
       {
          List<int> list = new List<int>();
          list.Add(1000);
          list.Add(2000);
          Console.WriteLine(list.ToString2());
          Console.WriteLine(list.ToString("N0"));
       }
    }
    // The example displays the following output:
    //       { 1000, 2000 }
    //       { 1,000, 2,000 }
    
    Imports System.Collections.Generic
    Imports System.Runtime.CompilerServices
    
    Public Module StringExtensions
       <Extension()>
       Public Function ToString2(Of T)(l As List(Of T)) As String
          Dim retVal As String = ""
          For Each item As T In l
             retVal += String.Format("{0}{1}", If(String.IsNullOrEmpty(retVal),
                                                         "", ", "),
                                      item)
          Next
          Return If(String.IsNullOrEmpty(retVal), "{}", "{ " + retVal + " }")
       End Function
    
       <Extension()>
       Public Function ToString(Of T)(l As List(Of T), fmt As String) As String
          Dim retVal As String = String.Empty
          For Each item In l
             Dim ifmt As IFormattable = TryCast(item, IFormattable)
             If ifmt IsNot Nothing Then
                retVal += String.Format("{0}{1}",
                                        If(String.IsNullOrEmpty(retval),
                                           "", ", "), ifmt.ToString(fmt, Nothing))
             Else
                retVal += ToString2(l)
             End If
          Next
          Return If(String.IsNullOrEmpty(retVal), "{}", "{ " + retVal + " }")
       End Function
    End Module
    
    Module Example
       Public Sub Main()
          Dim list As New List(Of Integer)
          list.Add(1000)
          list.Add(2000)
          Console.WriteLine(list.ToString2())
          Console.WriteLine(list.ToString("N0"))
       End Sub
    End Module
    ' The example displays the following output:
    '       { 1000, 2000 }
    '       { 1,000, 2,000 }
    

Hinweise zur Windows Runtime

Wenn Sie die -Methode für eine Klasse in der Windows Runtime aufrufen, wird das Standardverhalten für Klassen bereitgestellt, die ToString nicht ToString überschreiben. Dies ist Teil der Unterstützung, die .NET Framework für die Windows Runtime bietet (siehe .NET Framework-Unterstützung für Windows Store-Apps und Windows Runtime). Klassen in der Windows Runtime erben nicht und Object implementieren nicht immer eine ToString . Sie scheinen jedoch immer über die Methoden , und zu verfügen, wenn Sie sie in Ihrem C#- oder Visual Basic-Code verwenden, und die .NET Framework stellt ein Standardverhalten für diese Methoden ToString Equals(Object) zur GetHashCode Anwendung.

Ab .NET Framework 4.5.1 verwendet die Common Language Runtime IStringable.ToString für ein Windows Runtime-Objekt, bevor auf die Standardimplementierung von Object.ToString zurückfällt.

Hinweis

Windows Runtime-Klassen, die in C# oder Visual Basic können die -Methode ToString überschreiben.

Die Windows Runtime und die IStringable-Schnittstelle

Ab Windows 8.1 enthält die Windows Runtime eine IStringable-Schnittstelle, deren einzelne Methode, IStringable.ToString,eine grundlegende Formatierungsunterstützung bietet, die mit der von bereitgestellten vergleichbar Object.ToString ist. Um Mehrdeutigkeiten zu vermeiden, sollten Sie IStringable nicht für verwaltete Typen implementieren.

Wenn verwaltete Objekte durch nativen Code oder in Sprachen wie JavaScript oder C++/CX geschriebenen Code aufgerufen werden, scheinen sie IStringable zu implementieren. Die Common Language Runtime leitet Aufrufe von IStringable.ToString automatisch an weiter, wenn Object.ToString IStringable nicht für das verwaltete Objekt implementiert ist.

Warnung

Da die Common Language Runtime IStringable automatisch für alle verwalteten Typen in Windows Store-Apps implementiert, sollten Sie keine eigene Implementierung IStringable bereitstellen. Die Implementierung kann zu unbeabsichtigten Verhaltensweisen führen, wenn von der Windows IStringable ToString Runtime, C++/CX oder JavaScript aus aufruft.

Wenn Sie IStringable in einem öffentlichen verwalteten Typ implementieren möchten, der in eine Windows Runtime-Komponente exportiert wird, gelten die folgenden Einschränkungen:

  • Sie können die IStringable-Schnittstelle wie folgt nur in einer "Klassen implementiert"-Beziehung definieren:

    public class NewClass : IStringable
    
    Public Class NewClass : Implements IStringable
    
  • IStringable kann nicht für eine Schnittstelle implementiert werden.

  • Sie können einen Parameter nicht als IStringable-Typ deklarieren.

  • IStringable kann nicht der Rückgabetyp einer Methode, Eigenschaft oder eines Felds sein.

  • Sie können Ihre IStringable-Implementierung nicht mithilfe einer Methodendefinition wie der folgenden für Basisklassen ausblenden:

    
    public class NewClass : IStringable  
    {  
       public new string ToString()  
       {  
          return "New ToString in NewClass";  
       }  
    }  
    
    

    Stattdessen muss die Implementierung von IStringable.ToString immer die Basisklassenimplementierung überschreiben. Sie können eine ToString-Implementierung nur ausblenden, indem Sie sie auf einer stark typisierten Klasseninstanz aufrufen.

Beachten Sie, dass Aufrufe von systemeigenem Code an einen verwalteten Typ, der IStringable implementiert oder seine ToString-Implementierung ausblendet, unter verschiedenen Bedingungen zu unerwartetem Verhalten führen können.

Hinweise für Vererber

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

Außerkraftsetzungen der ToString() -Methode sollten die folgenden Richtlinien befolgen: – Die zurückgegebene Zeichenfolge sollte für Menschen benutzerfreundlicher und lesbar sein.

– Die zurückgegebene Zeichenfolge sollte den Wert der Objektinstanz 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 nicht oder Empty eine NULL-Zeichenfolge zurückgeben.

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

– Wenn die Zeichenfolgendarstellung einer Instanz kulturempfindlich ist oder auf mehrere 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 fordern. Wenn der Bedarf 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 Nebeneffekte haben, um Probleme beim Debuggen zu vermeiden. Beispielsweise sollte ein Aufruf der ToString() -Methode den Wert von Instanzfeldern nicht ändern.

– Wenn Ihr Typ eine Analysemethode implementiert (oder oder methode, einen Konstruktor oder eine andere statische Methode, die eine Instanz des Typs aus einer Zeichenfolge instanziiert), sollten Sie sicherstellen, dass die von der Methode zurückgegebene Zeichenfolge in eine Objektinstanz konvertiert werden Parse TryParse ToString() kann.

Gilt für

Siehe auch