RuntimeCompatibilityAttribute 類別

定義

命名空間:

System.Runtime.CompilerServices

組件:

System.Runtime.dll

來源:

RuntimeCompatibilityAttribute.cs

指定是否使用 Exception 物件來包裝不是衍生自 RuntimeWrappedException 類別的例外狀況。 此類別無法獲得繼承。

public ref class RuntimeCompatibilityAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false, Inherited=false)]
public sealed class RuntimeCompatibilityAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false, Inherited=false)>]
type RuntimeCompatibilityAttribute = class
    inherit Attribute

Public NotInheritable Class RuntimeCompatibilityAttribute
Inherits Attribute

繼承

Object

Attribute

RuntimeCompatibilityAttribute

屬性

AttributeUsageAttribute

範例

下列程式代碼範例示範如何將 類別套用 RuntimeCompatibilityAttribute 至在 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 例外狀況都衍生自 類別。 為了維持語言之間的相容性，Common Language Runtime (CLR) 包裝不會衍生自 Exception 物件中的 RuntimeWrappedException 物件。

您可以使用 RuntimeCompatibilityAttribute 類別來指定例外狀況是否應該出現在 catch 區塊和元件的例外狀況篩選內。 許多語言編譯程式，包括 Microsoft C# 和 Visual Basic 編譯程式，預設會套用這個屬性來指定包裝行為。

請注意，即使您使用 RuntimeCompatibilityAttribute 類別來指定不想要包裝例外狀況，運行時間仍會包裝例外狀況。 在此情況下，例外狀況只會解除包裝在 catch 區塊或例外狀況篩選內。

建構函式

RuntimeCompatibilityAttribute()

初始化 RuntimeCompatibilityAttribute 類別的新執行個體。

屬性

TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)
WrapNonExceptionThrows	取得或設定值，指出是否使用 Exception 物件來包裝不是衍生自 RuntimeWrappedException 類別的例外狀況。

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)