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 создает оболочку для объектов, которые не являются производными RuntimeWrappedException от Exception объекта.

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

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

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

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)

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