RuntimeWrappedException RuntimeWrappedException RuntimeWrappedException RuntimeWrappedException Class

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
RuntimeWrappedExceptionRuntimeWrappedExceptionRuntimeWrappedExceptionRuntimeWrappedException
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie zum Auslösen einer String Objekt als Ausnahme in C++, und fangen Sie mithilfe einer RuntimeWrappedException Objekt.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

Bei einigen Sprachen wie C++, können Sie Auslösen von Ausnahmen eines beliebigen verwalteten Typs.Some languages, such as C++, allow you to throw exceptions of any managed type. Andere Sprachen wie Microsoft C#- und Visual Basic erfordert, dass alle ausgelösten Ausnahme abgeleitet werden die Exception Klasse.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 verschiedenen Sprachen zu gewährleisten, die common Language Runtime (CLR) dient als Wrapper für Objekte, die nicht von abgeleitet sind Exception in einem RuntimeWrappedException 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, um anzugeben, ob Ausnahmen einer Assembly in einem Catch-Blöcke und bei Ausnahmefilter umschlossen werden soll.You can use the RuntimeCompatibilityAttribute class to specify whether exceptions should appear wrapped inside catch blocks and exception filters for an assembly. Viele Sprachcompiler, z. B. Microsoft C#- und Visual Basic, wenden Sie dieses Attribut standardmäßig Textumbruchverhalten angeben.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 Runtime Ausnahmen umschließt selbst bei Verwendung der RuntimeCompatibilityAttribute Klasse, um anzugeben, dass Sie nicht eingeschlossen 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 innerhalb von Catch-Blöcke und entpackt.In this case, exceptions are unwrapped only inside catch blocks or exception filters.

Konstruktoren

RuntimeWrappedException(Object) RuntimeWrappedException(Object) RuntimeWrappedException(Object) RuntimeWrappedException(Object)

Eigenschaften

Data Data Data 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.

(Inherited from Exception)
HelpLink HelpLink HelpLink 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.

(Inherited from Exception)
HResult HResult HResult 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.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

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

(Inherited from Exception)
Message Message Message Message

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

(Inherited from Exception)
Source Source Source 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.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

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

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

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

(Inherited from Exception)
WrappedException WrappedException WrappedException WrappedException

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

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() 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.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Exception)

Ereignisse

SerializeObjectState SerializeObjectState SerializeObjectState 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.

(Inherited from Exception)

Gilt für: