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