RuntimeWrappedException 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
包装不派生自类的 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
- 继承
- 属性
示例
下面的代码示例演示如何在 C++ 中将对象作为异常引发 String ,并使用对象捕获该 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) 包装不从 Exception 对象中 RuntimeWrappedException 派生的对象。
可以使用 RuntimeCompatibilityAttribute 该类来指定异常是否应出现在捕获块和程序集的异常筛选器内。 许多语言编译器(包括 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) |