Exception.ToString Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Zestaw:

mscorlib.dll

Zestaw:

netstandard.dll

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.

C#

public override string ToString ();

Zwraca

String

Reprezentacja ciągu bieżącego wyjątku.

Implementuje

ToString()

Przykłady

Poniższy przykład powoduje wyjątek i wyświetla wynik wywołania ToString tego wyjątku. Należy pamiętać, że Exception.ToString metoda jest wywoływana niejawnie, gdy wystąpienie klasy Exception pojawia się na liście argumentów Console.WriteLine metody.

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

Uwagi

ToString zwraca reprezentację bieżącego wyjątku, który ma być zrozumiały dla ludzi. Jeśli wyjątek zawiera dane wrażliwe na kulturę, reprezentacja ciągu zwrócona przez ToString jest wymagana do uwzględnienia bieżącej kultury systemu. Chociaż nie ma dokładnych wymagań dotyczących formatu zwracanego ciągu, należy spróbować odzwierciedlić wartość obiektu postrzeganego przez użytkownika.

Domyślna implementacja ToString uzyskuje nazwę klasy, która zwróciła bieżący wyjątek, komunikat, wynik wywołania ToString wyjątku wewnętrznego i wynik wywołania wywołania Environment.StackTrace. Jeśli którykolwiek z tych elementów członkowskich to null, jego wartość nie jest uwzględniona w zwracanym ciągu.

Jeśli nie ma komunikatu o błędzie lub jeśli jest to pusty ciąg (""), nie zostanie zwrócony żaden komunikat o błędzie. Nazwa wyjątku wewnętrznego i ślad stosu są zwracane tylko wtedy, gdy nie nullsą .

Ta metoda zastępuje Object.ToString.

Dotyczy