RuntimeCompatibilityAttribute クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

RuntimeCompatibilityAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

Exception クラスから派生していない例外を RuntimeWrappedException オブジェクトでラップするかどうかを指定します。このクラスは継承できません。

名前空間: System.Runtime.CompilerServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited:=False, AllowMultiple:=False)>
 _
Public NotInheritable Class
 RuntimeCompatibilityAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As RuntimeCompatibilityAttribute

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

C++

[SerializableAttribute] 
[AttributeUsageAttribute(AttributeTargets::Assembly, Inherited=false,
 AllowMultiple=false)] 
public ref class RuntimeCompatibilityAttribute
 sealed : public Attribute

/** @attribute SerializableAttribute() */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false,
 AllowMultiple=false) */ 
public final class RuntimeCompatibilityAttribute
 extends Attribute

JScript

SerializableAttribute 
AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false,
 AllowMultiple=false) 
public final class RuntimeCompatibilityAttribute
 extends Attribute

解説

C++ など、一部の言語では、任意の型の例外をスローできます。これに対し、Microsoft C# や Visual Basic など、それ以外の言語では、スローされる例外はすべて Exception クラスから派生している必要があります。これらの言語間の互換性を確保するため、Exception から派生していないオブジェクトは、共通言語ランタイム (CLR) により RuntimeWrappedException オブジェクトにラップされます。

RuntimeCompatibilityAttribute クラスを使用すると、例外をアセンブリの catch ブロックや例外フィルタ内にラップするどうかを指定できます。Microsoft C# や Visual Basic などのコンパイラでは、既定でこの属性を適用して、ラップの動作を指定します。

RuntimeCompatibilityAttribute クラスで例外がラップされないように指定したとしても、ランタイムによって例外がラップされる点に注意してください。この場合、例外がラップされないのは、catch ブロックと例外フィルタの中だけです。

使用例

アセンブリに RuntimeCompatibilityAttribute 属性を適用して、例外のラップを無効にするコード例を次に示します。

C++

using namespace System;
using namespace System::Runtime::CompilerServices;

[assembly:RuntimeCompatibilityAttribute(WrapNonExceptionThrows = false)];

void run()
{
     Console::WriteLine("The RuntimeCompatibilityAttribute was applied to disable
 exception wrapping.");
}

int main()
{
    run();

    return 0;
}