Exception.ToString-Methode

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

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

Syntax

'Declaration
Public Overrides Function ToString As String
'Usage
Dim instance As Exception
Dim returnValue As String

returnValue = instance.ToString

public override string ToString ()

public:
virtual String^ ToString () override

public String ToString ()

public override function ToString () : String

Rückgabewert

Eine Zeichenfolgenentsprechung der aktuellen Ausnahme.

Hinweise

ToString gibt eine Darstellung der aktuellen Ausnahme zurück, die in verständlicher Sprache gehalten ist. Wenn die Ausnahme kulturabhängige Daten enthält, muss die von ToString zurückgegebene Zeichenfolgenentsprechung die aktuelle Systemkultur berücksichtigen. Es gibt zwar keine genauen Vorschriften über das Format der zurückgegebenen Zeichenfolge, es sollte jedoch der Wert des Objekts wiedergeben werden, das vom Benutzer wahrgenommen wird.

Die Standardimplementierung von ToString erhält den Namen der Klasse, die die aktuelle Ausnahme ausgelöst hat, die Meldung, das Ergebnis des Aufrufs von ToString für die innere Ausnahme und das Ergebnis des Aufrufs von Environment.StackTrace. Wenn einer dieser Member NULL (Nothing in Visual Basic) ist, wird sein Wert nicht in die zurückgegebene Zeichenfolge aufgenommen.

Wenn keine Fehlermeldung vorhanden ist oder diese aus einer leeren Zeichenfolge besteht, wird keine Fehlermeldung zurückgegeben. Der Name der inneren Ausnahme und die Stapelüberwachung werden nur zurückgegeben, wenn sie nicht NULL (Nothing in Visual Basic) sind.

Diese Methode überschreibt Object.ToString.

Beispiel

Im folgenden Beispiel wird eine Ausnahme ausgelöst und das Ergebnis des Aufrufs von ToString für die Ausnahme ausgegeben.

Imports System

Public Class [MyClass]
End Class '[MyClass]

Public Class ArgExceptionExample
   
   Public Shared Sub Main()
      Dim my As New [MyClass]()
      Dim s As String = "sometext"
      Try
         Dim i As Integer = s.CompareTo(my)
      Catch e As Exception
         Console.WriteLine("Error: {0}", e.ToString())
      End Try
   End Sub 'Main
End Class 'ArgExceptionExample

using System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static void Main()
      {
      MyClass my = new MyClass();
      string s = "sometext";
      try 
         {
         int i = s.CompareTo(my);
         }
            catch (Exception e) 
            {
            Console.WriteLine("Error: {0}",e.ToString());
            }
      }
}

using namespace System;
public ref class MyClass{};

int main()
{
   MyClass^ my = gcnew MyClass;
   String^ s = "sometext";
   try
   {
      int i = s->CompareTo( my );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Error: {0}", e->ToString() );
   }

}

import System.*;

public class MyClass
{
} //MyClass

public class ArgExceptionExample
{
    public static void main(String[] args)
    {
        MyClass my = new MyClass();
        String s = "sometext";
        try {
            int i = s.CompareTo(my);
        }
        catch (System.Exception e) {
            Console.WriteLine("Error: {0}", e.ToString());
        }
    } //main
} //ArgExceptionExample

import System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static function Main()
      {
      var my : MyClass = new MyClass();
      var s : String = "sometext";
      try 
         {
         var i : int = s.CompareTo(my);
         }
     catch (e : Exception) 
         {
         Console.WriteLine("Error: {0}",e.ToString());
         }
      }
}

Dieser Code erzeugt die folgende Ausgabe:

Error: System.ArgumentException: Object must be of type String. at System.String.CompareTo(Object value) at ArgExceptionExample.Main()

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Exception-Klasse
Exception-Member
System-Namespace