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