RuntimeWrappedException Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Umschließt eine Ausnahme, die nicht von der Exception Klasse abgeleitet wird. Diese Klasse kann nicht vererbt werden.
public ref class RuntimeWrappedException sealed : Exception
[System.Serializable]
public sealed class RuntimeWrappedException : Exception
public sealed class RuntimeWrappedException : Exception
[<System.Serializable>]
type RuntimeWrappedException = class
inherit Exception
type RuntimeWrappedException = class
inherit Exception
Public NotInheritable Class RuntimeWrappedException
Inherits Exception
- Vererbung
- Attribute
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
In einigen Sprachen, z. B. C++, können Sie Ausnahmen von jedem verwalteten Typ auslösen. Andere Sprachen wie Microsoft C# und Visual Basic erfordern, dass jede ausgelöste Ausnahme von der klasse Exception abgeleitet wird. Um die Kompatibilität zwischen Sprachen aufrechtzuerhalten, umschließt die Common Language Runtime (CLR) Objekte, die nicht von Exception einem RuntimeWrappedException Objekt abgeleitet werden.
Mit der RuntimeCompatibilityAttribute Klasse können Sie angeben, ob Ausnahmen in Catch-Blö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 Catch-Blöcken oder Ausnahmefiltern entwappt.
Konstruktoren
| Name | Beschreibung |
|---|---|
| RuntimeWrappedException(Object) |
Initialisiert eine neue Instanz des Objekts, das RuntimeWrappedException das innere Ausnahmeobjekt enthält. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Data |
Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception) |
| HelpLink |
Dient zum Abrufen oder Festlegen eines Links zur Hilfedatei, die dieser Ausnahme zugeordnet ist. (Geerbt von Exception) |
| HResult |
Dient zum Abrufen oder Festlegen von HRESULT, einem codierten numerischen Wert, der einer bestimmten Ausnahme zugewiesen ist. (Geerbt von Exception) |
| InnerException |
Ruft die Exception Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception) |
| Message |
Ruft eine Nachricht ab, die die aktuelle Ausnahme beschreibt. (Geerbt von Exception) |
| Source |
Dient zum Abrufen oder Festlegen des Namens der Anwendung oder des Objekts, das den Fehler verursacht. (Geerbt von Exception) |
| StackTrace |
Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames im Aufrufstapel ab. (Geerbt von Exception) |
| TargetSite |
Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception) |
| WrappedException |
Ruft das Objekt ab, das RuntimeWrappedException vom Objekt umbrochen wurde. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetBaseException() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Exception Ursache einer oder mehrerer nachfolgenden Ausnahmen zurückgegeben. (Geerbt von Exception) |
| GetHashCode() |
Dient 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 der aktuellen Object. (Geerbt von Object) |
| ToString() |
Erstellt und gibt eine Zeichenfolgendarstellung der aktuellen Ausnahme zurück. (Geerbt von Exception) |
Ereignisse
| Name | Beschreibung |
|---|---|
| SerializeObjectState |
Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmestatusobjekt zu erstellen, das serialisierte Daten zu der Ausnahme enthält. (Geerbt von Exception) |