RuntimeWrappedException

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

RuntimeWrappedException クラス

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

Exception クラスから派生していない例外をラップします。このクラスは継承できません。

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

Visual Basic (宣言)

<SerializableAttribute> _
Public NotInheritable Class
 RuntimeWrappedException
    Inherits Exception

Visual Basic (使用法)

Dim instance As RuntimeWrappedException

C#

[SerializableAttribute] 
public sealed class RuntimeWrappedException
 : Exception

C++

[SerializableAttribute] 
public ref class RuntimeWrappedException sealed
 : public Exception

J#

/** @attribute SerializableAttribute() */ 
public final class RuntimeWrappedException
 extends Exception

JScript

SerializableAttribute 
public final class RuntimeWrappedException
 extends Exception

解説

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

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

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

使用例

C++ で文字列を例外としてスローし、それを RuntimeWrappedException オブジェクトを使ってキャッチする方法を次のコード例に示します。

C++

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

void run()
{
    try
    {
        throw "This is a string";

        Console::WriteLine("String exception thrown.");

    }
    catch(RuntimeWrappedException^ e)
    {
        Console::WriteLine("RuntimeWrappedException caught!");
    }
}

int main()
{
    run();

    return 0;
}

継承階層

System.Object
   System.Exception
    System.Runtime.CompilerServices.RuntimeWrappedException

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
RuntimeWrappedException メンバ
System.Runtime.CompilerServices 名前空間

RuntimeWrappedException プロパティ

パブリック プロパティ

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。 ( Exception から継承されます。)
	HelpLink	例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 ( Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。 ( Exception から継承されます。)
	Message	現在の例外を説明するメッセージを取得します。 ( Exception から継承されます。)
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。 ( Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。 ( Exception から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。 ( Exception から継承されます。)
	WrappedException	RuntimeWrappedException オブジェクトによってラップされたオブジェクトを取得します。

参照

関連項目

RuntimeWrappedException クラス
System.Runtime.CompilerServices 名前空間

RuntimeWrappedException メソッド

パブリック メソッド

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 ( Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetObjectData	オーバーライドされます。 例外に関する情報を使用して、SerializationInfo オブジェクトを設定します。
	GetType	現在のインスタンスのランタイム型を取得します。 ( Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 ( Exception から継承されます。)

参照

関連項目

RuntimeWrappedException クラス
System.Runtime.CompilerServices 名前空間

RuntimeWrappedException メンバ

Exception クラスから派生していない例外をラップします。このクラスは継承できません。

RuntimeWrappedException データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。(Exception から継承されます。)
	HelpLink	例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。(Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。(Exception から継承されます。)
	Message	現在の例外を説明するメッセージを取得します。(Exception から継承されます。)
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。(Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。(Exception から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。(Exception から継承されます。)
	WrappedException	RuntimeWrappedException オブジェクトによってラップされたオブジェクトを取得します。

パブリック メソッド

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 (Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetObjectData	オーバーライドされます。 例外に関する情報を使用して、SerializationInfo オブジェクトを設定します。
	GetType	現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)

参照

関連項目

RuntimeWrappedException クラス
System.Runtime.CompilerServices 名前空間