RuntimeWrappedException Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Atributos
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 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 ajustando las 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) |
Obsoletos.
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 |
Obsoletos.
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) |