RuntimeWrappedException Klasse

Definition

Umschließt eine Ausnahme, die nicht von der Exception-Klasse abgeleitet ist.Wraps an exception that does not derive from the Exception class. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class RuntimeWrappedException sealed : Exception
[System.Serializable]
public sealed class RuntimeWrappedException : Exception
type RuntimeWrappedException = class
    inherit Exception
Public NotInheritable Class RuntimeWrappedException
Inherits Exception
Vererbung
RuntimeWrappedException
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein String -Objekt als Ausnahme in C++ ausgelöst und mithilfe eines RuntimeWrappedException -Objekts abgefangen wird.The following code example demonstrates how to throw a String object as an exception in C++ and catch it using a RuntimeWrappedException object.

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, wie C++z. b., können Sie Ausnahmen eines beliebigen verwalteten Typs auslösen.Some languages, such as C++, allow you to throw exceptions of any managed type. Andere Sprachen, wie z. C# b. Microsoft und Visual Basic, erfordern, dass jede ausgelöste Exception Ausnahme von der-Klasse abgeleitet wird.Other languages, such as Microsoft C# and Visual Basic, require that every thrown exception be derived from the Exception class. Um die Kompatibilität zwischen den Sprachen zu gewährleisten, umschließt die Common Language Runtime (CLR) Objekte Exception , die RuntimeWrappedException nicht von abgeleitet sind, in einem-Objekt.To maintain compatibility between languages, the common language runtime (CLR) wraps objects that do not derive from Exception in a RuntimeWrappedException object.

Sie können die RuntimeCompatibilityAttribute -Klasse verwenden, um anzugeben, ob Ausnahmen in catch-Blöcken und Ausnahme Filter für eine Assembly umfänden angezeigt werden sollen.You can use the RuntimeCompatibilityAttribute class to specify whether exceptions should appear wrapped inside catch blocks and exception filters for an assembly. Viele sprach Compiler, einschließlich der Microsoft C# -und Visual Basic Compiler, wenden dieses Attribut standardmäßig an, um das Wrapping Verhalten anzugeben.Many language compilers, including the Microsoft C# and Visual Basic compilers, apply this attribute by default to specify the wrapping behavior.

Beachten Sie, dass die Laufzeit weiterhin Ausnahmen umschließt, auch RuntimeCompatibilityAttribute Wenn Sie die-Klasse verwenden, um anzugeben, dass Sie nicht umschlossen werden sollen.Note that the runtime still wraps exceptions even if you use the RuntimeCompatibilityAttribute class to specify that you do not want them wrapped. In diesem Fall werden Ausnahmen nur in catch-Blöcken oder Ausnahme Filtern entpackt.In this case, exceptions are unwrapped only inside catch blocks or exception filters.

Konstruktoren

RuntimeWrappedException(Object)

Eigenschaften

Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen über die Ausnahme bereitstellen.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Geerbt von Exception)
HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.Gets or sets a link to the help file associated with this exception.

(Geerbt von Exception)
HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Geerbt von Exception)
InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.Gets the Exception instance that caused the current exception.

(Geerbt von Exception)
Message

Ruft eine Meldung ab, die die aktuelle Ausnahme beschreibt.Gets a message that describes the current exception.

(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.Gets or sets the name of the application or the object that causes the error.

(Geerbt von Exception)
StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.Gets a string representation of the immediate frames on the call stack.

(Geerbt von Exception)
TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.Gets the method that throws the current exception.

(Geerbt von Exception)
WrappedException

Ruft das vom RuntimeWrappedException-Objekt umschlossene Objekt ab.Gets the object that was wrapped by the RuntimeWrappedException object.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Geerbt von Exception)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)

Legt das SerializationInfo-Objekt mit Informationen zur Ausnahme fest.Sets the SerializationInfo object with information about the exception.

GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.Gets the runtime type of the current instance.

(Geerbt von Exception)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.Creates and returns a string representation of the current exception.

(Geerbt von Exception)

Ereignisse

SerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Geerbt von Exception)

Gilt für: