RuntimeCompatibilityAttribute クラス

定義

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)]
[System.Serializable]
public sealed class RuntimeCompatibilityAttribute : Attribute

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

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

Public NotInheritable Class RuntimeCompatibilityAttribute
Inherits Attribute

継承

Object

Attribute

RuntimeCompatibilityAttribute

属性

AttributeUsageAttribute SerializableAttribute

例

次のコード例では、String オブジェクトを C++ の例外としてスローし、RuntimeWrappedException オブジェクトを使用してキャッチするアセンブリにRuntimeCompatibilityAttribute クラスを適用する方法を示します。

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 クラスを使用して、アセンブリの catch ブロックと例外フィルター内で例外をラップするかどうかを指定できます。 Microsoft C# コンパイラや Visual Basic コンパイラなど、多くの言語コンパイラでは、この属性を既定で適用して折り返し動作を指定します。

RuntimeCompatibilityAttribute クラスを使用して例外をラップしないように指定した場合でも、ランタイムは例外をラップします。 この場合、例外は catch ブロックまたは例外フィルター内でのみラップ解除されます。