RuntimeCompatibilityAttribute Класс

Определение

Пространство имен:

System.Runtime.CompilerServices

Сборка:

System.Runtime.dll

Исходный код:

RuntimeCompatibilityAttribute.cs

Указывает, следует ли создавать оболочку для выражений, не являющихся производными от класса Exception, в виде объекта RuntimeWrappedException. Этот класс не наследуется.

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

Наследование

Object

Attribute

RuntimeCompatibilityAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере кода показано, как применить RuntimeCompatibilityAttribute класс к сборке, которая создает String объект в качестве исключения в C++ и перехватывает его с помощью RuntimeWrappedException объекта .

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;
}

Комментарии

Некоторые языки, такие как C++, позволяют создавать исключения любого типа. Другие языки, такие как Microsoft C# и Visual Basic, требуют, чтобы каждое созданное исключение было производным Exception от класса . Для обеспечения совместимости между языками среда CLR создает оболочку для объектов, которые не являются производными от Exception в объекте RuntimeWrappedException .

Класс можно использовать, RuntimeCompatibilityAttribute чтобы указать, должны ли исключения отображаться в оболочке внутри блоков catch и фильтров исключений для сборки. Многие языковые компиляторы, включая компиляторы Microsoft C# и Visual Basic, по умолчанию применяют этот атрибут для указания поведения оболочки.

Обратите внимание, что среда выполнения по-прежнему создает оболочку для исключений, даже если вы используете RuntimeCompatibilityAttribute класс , чтобы указать, что они не должны быть заключены в оболочку. В этом случае исключения распакуются только внутри блоков catch или фильтров исключений.

Конструкторы

RuntimeCompatibilityAttribute()

Инициализирует новый экземпляр класса RuntimeCompatibilityAttribute.

Свойства

TypeId	В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)
WrapNonExceptionThrows	Получает или задает значение, указывающее, следует ли создавать оболочку для исключений, не являющихся производными от класса Exception, в виде объекта RuntimeWrappedException.

Методы

Equals(Object)	Возвращает значение, показывающее, равен ли экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)