RuntimeCompatibilityAttribute Класс

Определение

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

System.Runtime.CompilerServices

Сборка:

mscorlib.dll

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

public ref class RuntimeCompatibilityAttribute sealed : 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)>]
[<System.Serializable>]
type RuntimeCompatibilityAttribute = class
    inherit Attribute

Public NotInheritable Class RuntimeCompatibilityAttribute
Inherits Attribute

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

Object

Attribute

RuntimeCompatibilityAttribute

Атрибуты

AttributeUsageAttribute SerializableAttribute

Примеры

В следующем примере кода показано, как применить 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 упаковывает объекты, не производные от ExceptionRuntimeWrappedException объекта.

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

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

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

Имя	Описание
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)

Явные реализации интерфейса

Имя	Описание
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Извлекает сведения о типе объекта, который можно использовать для получения сведений о типе для интерфейса. (Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Предоставляет доступ к свойствам и методам, предоставляемым объектом. (Унаследовано от Attribute)