RuntimeWrappedException Klasse

Definition

Namespace:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Umschließt eine Ausnahme, die nicht von der Exception-Klasse abgeleitet ist. Diese Klasse kann nicht vererbt werden.

public ref class RuntimeWrappedException sealed : Exception

public sealed class RuntimeWrappedException : Exception

[System.Serializable]
public sealed class RuntimeWrappedException : Exception

type RuntimeWrappedException = class
    inherit Exception

[<System.Serializable>]
type RuntimeWrappedException = class
    inherit Exception

Public NotInheritable Class RuntimeWrappedException
Inherits Exception

Vererbung

Object

Exception

RuntimeWrappedException

Attribute

SerializableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein String Objekt als Ausnahme in C++ ausgelöst und mithilfe eines RuntimeWrappedException Objekts erfasst wird.

using namespace System;
using namespace System::Runtime::CompilerServices;

[assembly:RuntimeCompatibilityAttribute(WrapNonExceptionThrows = true)]; 

void run()
{
    try
    {
        throw gcnew String("This is a string");

    }
    catch(RuntimeWrappedException^ e)
    {
        Console::WriteLine("RuntimeWrappedException caught!");
    }
}

int main()
{
    run();

    return 0;
}

Hinweise

Einige Sprachen, z. B. C++, ermöglichen es Ihnen, Ausnahmen von jedem verwalteten Typ auszuwerfen. Andere Sprachen, z. B. Microsoft C# und Visual Basic, erfordern, dass jede ausgelöste Ausnahme von der Exception Klasse abgeleitet werden kann. Um die Kompatibilität zwischen Sprachen aufrechtzuerhalten, umschließt die CLR (Common Language Runtime) Objekte, die nicht von Exception einem RuntimeWrappedException Objekt abgeleitet werden.

Sie können die RuntimeCompatibilityAttribute Klasse verwenden, um anzugeben, ob Ausnahmen innerhalb von Fangblöcken und Ausnahmefiltern für eine Assembly eingeschlossen werden sollen. Viele Sprachcompiler, einschließlich der Microsoft C#- und Visual Basic Compiler, wenden dieses Attribut standardmäßig an, um das Umbruchverhalten anzugeben.

Beachten Sie, dass die Laufzeit weiterhin Ausnahmen umschließt, auch wenn Sie die RuntimeCompatibilityAttribute Klasse verwenden, um anzugeben, dass sie nicht umschlossen werden sollen. In diesem Fall werden Ausnahmen nur innerhalb von Fangblöcken oder Ausnahmefiltern aufgehoben.

Konstruktoren

RuntimeWrappedException(Object)

Initialisiert eine neue Instanz der RuntimeWrappedException, die das innere Ausnahmeobjekt enthält.

Eigenschaften

Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception)
HelpLink	Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Geerbt von Exception)
HResult	Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Geerbt von Exception)
InnerException	Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception)
Message	Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird. (Geerbt von Exception)
Source	Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest. (Geerbt von Exception)
StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Geerbt von Exception)
TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception)
WrappedException	Ruft das vom RuntimeWrappedException-Objekt umschlossene Objekt ab.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBaseException()	Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist. (Geerbt von Exception)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Legt das SerializationInfo-Objekt mit Informationen zur Ausnahme fest.
GetType()	Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück. (Geerbt von Exception)

Ereignisse

SerializeObjectState

Veraltet. Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen. (Geerbt von Exception)