RuntimeWrappedException Classe

Definição

public ref class RuntimeWrappedException sealed : Exception

[System.Serializable]
public sealed class RuntimeWrappedException : Exception

public sealed class RuntimeWrappedException : Exception

[<System.Serializable>]
type RuntimeWrappedException = class
    inherit Exception

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 em 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 que você gere exceções de qualquer tipo gerenciado. Outros idiomas, como Microsoft C# e Visual Basic, exigem que cada exceção gerada seja derivada da classe Exception. 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 de captura e filtros de exceção para um assembly. Muitos compiladores de linguagem, 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 deseja que elas sejam encapsuladas. Nesse caso, as exceções são desembrulhadas somente dentro de blocos de captura ou filtros de exceção.