RuntimeWrappedException Класс

Определение

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

public ref class RuntimeWrappedException sealed : Exception
public sealed class RuntimeWrappedException : Exception
[System.Serializable]
public sealed class RuntimeWrappedException : Exception
type RuntimeWrappedException = class
    inherit Exception
[<System.Serializable>]
type RuntimeWrappedException = class
    inherit Exception
Public NotInheritable Class RuntimeWrappedException
Inherits 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 упаковывает объекты, не производные от ExceptionRuntimeWrappedException объекта.

Класс можно использовать 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)

Применяется к