RuntimeCompatibilityAttribute Classe

Definição

Namespace:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Origem:

RuntimeCompatibilityAttribute.cs

Especifica se deve encapsular as exceções que não derivam da classe Exception com um objeto RuntimeWrappedException. Essa classe não pode ser herdada.

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)>]
type RuntimeCompatibilityAttribute = class
    inherit Attribute

Public NotInheritable Class RuntimeCompatibilityAttribute
Inherits Attribute

Herança

Object

Attribute

RuntimeCompatibilityAttribute

Atributos

AttributeUsageAttribute

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. 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 em 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 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 catch ou filtros de exceção.

Construtores

RuntimeCompatibilityAttribute()

Inicializa uma nova instância da classe RuntimeCompatibilityAttribute.

Propriedades

TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)
WrapNonExceptionThrows	Obtém ou define um valor que indica se deverá encapsular as exceções não derivadas da classe Exception com um RuntimeWrappedException objeto.

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)