Exception.ToString Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

Exception.cs

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.

C#

public override string ToString();

Gibt zurück

String

Eine Zeichenfolgendarstellung der aktuellen Ausnahme.

Beispiele

Das folgende Beispiel verursacht eine Ausnahme und zeigt das Ergebnis des Aufrufs ToString dieser Ausnahme an. Beachten Sie, dass die Exception.ToString -Methode implizit aufgerufen wird, wenn die Exception-Klasseninstanz in der Argumentliste der Console.WriteLine -Methode angezeigt wird.

C#

using System;

public class TestClass
{}

public class Example
{
   public static void Main()
   {
      var test = new TestClass();
      Object[] objectsToCompare = { test, test.ToString(), 123,
                                    123.ToString(), "some text",
                                    "Some Text" };
      string s = "some text";
      foreach (var objectToCompare in objectsToCompare) {
         try {
            int i = s.CompareTo(objectToCompare);
            Console.WriteLine("Comparing '{0}' with '{1}': {2}",
                              s, objectToCompare, i);
         }
         catch (ArgumentException e) {
            Console.WriteLine("Bad argument: {0} (type {1})",
                              objectToCompare,
                              objectToCompare.GetType().Name);
            Console.WriteLine("Exception information: {0}", e);
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//     Bad argument: TestClass (type TestClass)
//     Exception information: System.ArgumentException: Object must be of type String.
//        at System.String.CompareTo(Object value)
//        at Example.Main()
//
//     Comparing 'some text' with 'TestClass': -1
//
//     Bad argument: 123 (type Int32)
//     Exception information: System.ArgumentException: Object must be of type String.
//        at System.String.CompareTo(Object value)
//        at Example.Main()
//
//     Comparing 'some text' with '123': 1
//
//     Comparing 'some text' with 'some text': 0
//
//     Comparing 'some text' with 'Some Text': -1

Hinweise

ToString gibt eine Darstellung der aktuellen Ausnahme zurück, die von Menschen verstanden werden soll. Wenn die Ausnahme kulturrelevante Daten enthält, muss die von ToString zurückgegebene Zeichenfolgendarstellung die aktuelle Systemkultur berücksichtigen. Obwohl es keine genauen Anforderungen für das Format der zurückgegebenen Zeichenfolge gibt, sollte sie versuchen, den Wert des Objekts widerzuspiegeln, der vom Benutzer wahrgenommen wird.

Die Standardimplementierung von ToString ruft den Namen der -Klasse ab, die die aktuelle Ausnahme ausgelöst hat, die Nachricht, das Ergebnis des Aufrufens ToString der inneren Ausnahme und das Ergebnis des Aufrufens Environment.StackTrace. Wenn eines dieser Member ist, ist nullsein Wert nicht in der zurückgegebenen Zeichenfolge enthalten.

Wenn keine Fehlermeldung vorhanden ist oder es sich um eine leere Zeichenfolge ("") handelt, wird keine Fehlermeldung zurückgegeben. Der Name der inneren Ausnahme und die Stapelablaufverfolgung werden nur zurückgegeben, wenn sie nicht nullsind.

Diese Methode überschreibt Object.ToString.

Gilt für: