RuntimeWrappedException Classe

Definição

Namespace:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Encapsula uma exceção que não deriva da classe Exception. Essa classe não pode ser herdada.

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

Herança

Object

Exception

RuntimeWrappedException

Atributos

SerializableAttribute

Exemplos

O exemplo de código a seguir demonstra como lançar um String objeto como uma exceção no C++ e pegá-lo usando um 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;
}

Comentários

Alguns idiomas, como C++, permitem gerar exceções de qualquer tipo gerenciado. Outras linguagens, como Microsoft C# e Visual Basic, exigem que cada exceção gerada seja derivada da Exception classe. Para manter a compatibilidade entre idiomas, o CLR (common language runtime) encapsula objetos que não derivam de Exception um RuntimeWrappedException objeto.

Você pode usar a RuntimeCompatibilityAttribute classe para especificar se as exceções devem aparecer encapsuladas dentro de blocos catch e filtros de exceção para um assembly. Muitos compiladores de idiomas, incluindo os compiladores microsoft C# e Visual Basic, aplicam esse atributo por padrão para especificar o comportamento de encapsulamento.

Observe que o runtime ainda encapsula exceções mesmo se você usar a RuntimeCompatibilityAttribute classe para especificar que não as deseja encapsuladas. Nesse caso, as exceções são desembrulhadas somente dentro de blocos catch ou filtros de exceção.

Construtores

RuntimeWrappedException(Object)

Inicializa uma nova instância do RuntimeWrappedException que contém o objeto de exceção interna.

Propriedades

Data	Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção. (Herdado de Exception)
HelpLink	Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception)
HResult	Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception)
InnerException	Obtém a instância Exception que causou a exceção atual. (Herdado de Exception)
Message	Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception)
Source	Obtém ou define o nome do aplicativo ou objeto que causa o erro. (Herdado de Exception)
StackTrace	Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que gerou a exceção atual. (Herdado de Exception)
WrappedException	Obtém o objeto encapsulado pelo objeto RuntimeWrappedException.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBaseException()	Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Define o objeto SerializationInfo com informações sobre a exceção.
GetType()	Obtém o tipo de runtime da instância atual. (Herdado de Exception)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception)

Eventos

SerializeObjectState

Obsoleto. Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception)