RuntimeWrappedException Класс

Определение

Создает оболочку для исключения, не являющегося производным от класса Exception.Wraps an exception that does not derive from the Exception class. Этот класс не наследуется.This class cannot be inherited.

public ref class RuntimeWrappedException sealed : Exception
[System.Serializable]
public sealed class RuntimeWrappedException : Exception
type RuntimeWrappedException = class
    inherit Exception
Public NotInheritable Class RuntimeWrappedException
Inherits Exception
Наследование
RuntimeWrappedException
Атрибуты

Примеры

В следующем примере кода показано, как создать String объект как исключение в C++ и RuntimeWrappedException перехватить его с помощью объекта.The following code example demonstrates how to throw a String object as an exception in C++ and catch it using a RuntimeWrappedException object.

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++, позволяют создавать исключения любого управляемого типа.Some languages, such as C++, allow you to throw exceptions of any managed type. Для других языков, таких как C# Microsoft и Visual Basic, необходимо, чтобы каждое порожденное исключение Exception было производным от класса.Other languages, such as Microsoft C# and Visual Basic, require that every thrown exception be derived from the Exception class. Чтобы обеспечить совместимость между языками, среда CLR заключает объекты, которые не являются производными от Exception , RuntimeWrappedException в объекте.To maintain compatibility between languages, the common language runtime (CLR) wraps objects that do not derive from Exception in a RuntimeWrappedException object.

Можно использовать RuntimeCompatibilityAttribute класс, чтобы указать, должны ли исключения переноситься внутрь блоков catch и фильтров исключений для сборки.You can use the RuntimeCompatibilityAttribute class to specify whether exceptions should appear wrapped inside catch blocks and exception filters for an assembly. Многие языковые компиляторы, включая компиляторы C# Microsoft и Visual Basic, применяют этот атрибут по умолчанию для указания поведения при переносе.Many language compilers, including the Microsoft C# and Visual Basic compilers, apply this attribute by default to specify the wrapping behavior.

Обратите внимание, что среда выполнения по-прежнему заключает исключения, RuntimeCompatibilityAttribute даже если вы используете класс, чтобы указать, что они не должны быть упакованы.Note that the runtime still wraps exceptions even if you use the RuntimeCompatibilityAttribute class to specify that you do not want them wrapped. В этом случае исключения разносятся только внутри блоков catch и фильтров исключений.In this case, exceptions are unwrapped only inside catch blocks or exception filters.

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

RuntimeWrappedException(Object)

Свойства

Data

Возвращает коллекцию пар ключ/значение, предоставляющие дополнительные сведения об исключении, определяемые пользователем.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Унаследовано от Exception)
HelpLink

Получает или задает ссылку на файл справки, связанный с этим исключением.Gets or sets a link to the help file associated with this exception.

(Унаследовано от Exception)
HResult

Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Унаследовано от Exception)
InnerException

Возвращает экземпляр класса Exception, который вызвал текущее исключение.Gets the Exception instance that caused the current exception.

(Унаследовано от Exception)
Message

Возвращает сообщение, описывающее текущее исключение.Gets a message that describes the current exception.

(Унаследовано от Exception)
Source

Возвращает или задает имя приложения или объекта, вызывавшего ошибку.Gets or sets the name of the application or the object that causes the error.

(Унаследовано от Exception)
StackTrace

Получает строковое представление непосредственных кадров в стеке вызова.Gets a string representation of the immediate frames on the call stack.

(Унаследовано от Exception)
TargetSite

Возвращает метод, создавший текущее исключение.Gets the method that throws the current exception.

(Унаследовано от Exception)
WrappedException

Возвращает объект, заключенный в оболочку объекта RuntimeWrappedException.Gets the object that was wrapped by the RuntimeWrappedException object.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetBaseException()

При переопределении в производном классе возвращает исключение Exception, которое является корневой причиной одного или нескольких последующих исключений.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Унаследовано от Exception)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)

Задает объект SerializationInfo, содержащий информацию об исключении.Sets the SerializationInfo object with information about the exception.

GetType()

Возвращает тип среды выполнения текущего экземпляра.Gets the runtime type of the current instance.

(Унаследовано от Exception)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Создает и возвращает строковое представление текущего исключения.Creates and returns a string representation of the current exception.

(Унаследовано от Exception)

События

SerializeObjectState

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Унаследовано от Exception)

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