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 seguinte demonstra como aplicar a RuntimeCompatibilityAttribute classe a um assembly que lança um String objeto como exceção em C++ e o apanha 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;
}

Observações

Algumas linguagens, como o C++, permitem lançar exceções de qualquer tipo. Outras linguagens, como Microsoft C# e Visual Basic, exigem que cada exceção lançada seja derivada da classe Exception. Para manter a compatibilidade entre linguagens, o tempo de execução da linguagem comum (CLR) envolve objetos que não derivam de Exception dentro de um RuntimeWrappedException objeto.

Podes usar a RuntimeCompatibilityAttribute classe para especificar se as exceções devem aparecer encapsuladas dentro de blocos de captura e filtros de exceção para uma assembleia. Muitos compiladores de linguagens, incluindo os compiladores Microsoft C# e Visual Basic, aplicam este atributo por defeito para especificar o comportamento de envolvimento.

Note que o runtime continua a envolver exceções mesmo que use a RuntimeCompatibilityAttribute classe para especificar que não quer que sejam encapsuladas. Neste caso, as exceções são desembrulhadas apenas dentro dos blocos de captura ou filtros de exceção.