RuntimeWrappedException Clase

Definición

Espacio de nombres:

System.Runtime.CompilerServices

Ensamblado:

System.Runtime.dll

Ensamblado:

mscorlib.dll

Ensamblado:

netstandard.dll

Ajusta una excepción que no deriva de la clase Exception. Esta clase no puede heredarse.

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

Herencia

Object

Exception

RuntimeWrappedException

Atributos

SerializableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo iniciar un String objeto como una excepción en C++ y detectarlo mediante un RuntimeWrappedException objeto .

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;
}

Comentarios

Algunos lenguajes, como C++, permiten producir excepciones de cualquier tipo administrado. Otros lenguajes, como Microsoft C# y Visual Basic, requieren que todas las excepciones producidas se deriven de la Exception clase . Para mantener la compatibilidad entre los lenguajes, Common Language Runtime (CLR) encapsula los objetos que no derivan de Exception en un RuntimeWrappedException objeto .

Puede usar la RuntimeCompatibilityAttribute clase para especificar si las excepciones deben aparecer encapsuladas dentro de bloques catch y filtros de excepción para un ensamblado. Muchos compiladores de lenguaje, incluidos los compiladores de Microsoft C# y Visual Basic, aplican este atributo de forma predeterminada para especificar el comportamiento de ajuste.

Tenga en cuenta que el tiempo de ejecución sigue encapsulando excepciones incluso si usa la RuntimeCompatibilityAttribute clase para especificar que no desea que se ajusten. En este caso, las excepciones solo se desencapsulan dentro de los bloques catch o los filtros de excepción.

Constructores

RuntimeWrappedException(Object)

Inicializa una nueva instancia del objeto RuntimeWrappedException que contiene el objeto de excepción interna.

Propiedades

Data	Obtiene una colección de pares clave/valor que proporciona información definida por el usuario adicional sobre la excepción. (Heredado de Exception)
HelpLink	Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción. (Heredado de Exception)
HResult	Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica. (Heredado de Exception)
InnerException	Obtiene la instancia Exception que produjo la excepción actual. (Heredado de Exception)
Message	Obtiene un mensaje que describe la excepción actual. (Heredado de Exception)
Source	Devuelve o establece el nombre de la aplicación o del objeto que generó el error. (Heredado de Exception)
StackTrace	Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas. (Heredado de Exception)
TargetSite	Obtiene el método que produjo la excepción actual. (Heredado de Exception)
WrappedException	Obtiene el objeto ajustado por el objeto RuntimeWrappedException.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetBaseException()	Cuando se invalida en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores. (Heredado de Exception)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Establece el objeto SerializationInfo con información sobre la excepción.
GetType()	Obtiene el tipo de tiempo de ejecución de la instancia actual. (Heredado de Exception)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Crea y devuelve una representación de cadena de la excepción actual. (Heredado de Exception)

Eventos

SerializeObjectState

Obsoleto. Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción. (Heredado de Exception)