RuntimeWrappedException Класс

Определение

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

System.Runtime.CompilerServices

Сборка:

System.Runtime.dll

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

RuntimeWrappedException.cs

Создает оболочку для исключения, не являющегося производным от класса Exception. Этот класс не наследуется.

public ref class RuntimeWrappedException sealed : Exception

public sealed class RuntimeWrappedException : Exception

type RuntimeWrappedException = class
    inherit Exception

Public NotInheritable Class RuntimeWrappedException
Inherits Exception

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

Object

Exception

RuntimeWrappedException

Примеры

В следующем примере кода показано, как создать 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 класс , чтобы указать, что они не должны быть упакованы. В этом случае исключения распакуются только внутри блоков перехвата или фильтров исключений.

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

RuntimeWrappedException(Object)

Инициализирует новый экземпляр класса RuntimeWrappedException, содержащий объект внутреннего исключения.

Свойства

Data	Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении. (Унаследовано от Exception)
HelpLink	Получает или задает ссылку на файл справки, связанный с этим исключением. (Унаследовано от Exception)
HResult	Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению. (Унаследовано от Exception)
InnerException	Возвращает экземпляр класса Exception, который вызвал текущее исключение. (Унаследовано от Exception)
Message	Возвращает сообщение, описывающее текущее исключение. (Унаследовано от Exception)
Source	Возвращает или задает имя приложения или объекта, вызывавшего ошибку. (Унаследовано от Exception)
StackTrace	Получает строковое представление непосредственных кадров в стеке вызова. (Унаследовано от Exception)
TargetSite	Возвращает метод, создавший текущее исключение. (Унаследовано от Exception)
WrappedException	Возвращает объект, заключенный в оболочку объекта RuntimeWrappedException.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBaseException()	При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений. (Унаследовано от Exception)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)	Устаревшие.. Задает объект SerializationInfo с данными об исключении.
GetType()	Возвращает тип среды выполнения текущего экземпляра. (Унаследовано от Exception)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception)

События

SerializeObjectState

Устаревшие.. Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении. (Унаследовано от Exception)