RuntimeCompatibilityAttribute Classe

Definição

public ref class RuntimeCompatibilityAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false, Inherited=false)]
public sealed class RuntimeCompatibilityAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false, Inherited=false)]
[System.Serializable]
public sealed class RuntimeCompatibilityAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false, Inherited=false)>]
type RuntimeCompatibilityAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false, Inherited=false)>]
[<System.Serializable>]
type RuntimeCompatibilityAttribute = class
    inherit Attribute

Public NotInheritable Class RuntimeCompatibilityAttribute
Inherits Attribute

Herança

Object

Attribute

RuntimeCompatibilityAttribute

Atributos

AttributeUsageAttribute SerializableAttribute

Exemplos

O exemplo de código a seguir demonstra como aplicar a RuntimeCompatibilityAttribute classe a um assembly que gera um String objeto como uma exceção no C++ e o captura 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. 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.