RuntimeWrappedException RuntimeWrappedException RuntimeWrappedException RuntimeWrappedException Class

Определение

Создает оболочку для исключения, не являющегося производным от класса 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
Наследование
RuntimeWrappedExceptionRuntimeWrappedExceptionRuntimeWrappedExceptionRuntimeWrappedException
Атрибуты

Примеры

В следующем примере кода показано, как создавать 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. Требуют других языках, таких как Microsoft C# и 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. Многие языковые компиляторы, включая компиляторы Microsoft C# и 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) RuntimeWrappedException(Object) RuntimeWrappedException(Object) RuntimeWrappedException(Object)

Свойства

Data Data Data Data

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

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

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

(Inherited from Exception)
HResult HResult HResult HResult

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

(Inherited from Exception)
InnerException InnerException InnerException InnerException

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

(Inherited from Exception)
Message Message Message Message

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

(Inherited from Exception)
Source Source Source Source

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

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

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

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

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

(Inherited from Exception)
WrappedException WrappedException WrappedException WrappedException

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

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

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

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Exception)

События

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

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

(Inherited from Exception)

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