COMException クラス

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

COMException クラス

COM メソッドの呼び出しによって、認識されない HRESULT が返された場合にスローされる例外です。

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

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class COMException
    Inherits ExternalException

Visual Basic (使用法)

Dim instance As COMException

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class COMException : ExternalException

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class COMException : public
 ExternalException

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class COMException extends ExternalException

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class COMException extends
 ExternalException

解説

共通言語ランタイムは既知の HRESULT を .NET 例外に変換します。これによって COM オブジェクトは意味のあるエラー情報をマネージ クライアントに対して返すことができます。HRESULT と例外の割り当ては、逆方向でも機能します。この場合は、特定の HRESULT をアンマネージ クライアントに返します。割り当ての詳細については、「方法 : HRESULT に例外を割り当てる」を参照してください。

共通言語ランタイムは未知の HRESULT (特定の対応する例外がない HRESULT) に遭遇すると、COMException クラスのインスタンスをスローします。この汎用の例外は、通常の例外と同じメンバを公開します。また、呼び出し先が返す HRESULT を格納するパブリック ErrorCode プロパティが含まれています。エラー メッセージ (IErrorInfo インターフェイス、Visual Basic の Err オブジェクト、または一部のケースではオペレーティング システムから発生した) が共通言語ランタイムで利用できる場合、このエラー メッセージは呼び出し元に返されます。ただし、COM コンポーネントにエラー メッセージが含まれていない場合、共通言語ランタイムはメッセージの文字列の代わりに 8 桁の HRESULT を返します。HRESULT があると、呼び出し元はこの汎用例外の原因を特定できます。

COMException クラスを使用して特定の HRESULT をアンマネージ クライアントに返すことができますが、汎用の例外ではなく .NET 例外を使用することをお勧めします。アンマネージ クライアントと同様にマネージ クライアントでも .NET オブジェクトを使用できます。また、HRESULT をマネージ クライアントの呼び出し元にスローした場合、例外をスローした場合より状況がわかりにくくなります。

継承階層

System.Object
   System.Exception
     System.SystemException
       System.Runtime.InteropServices.ExternalException
        System.Runtime.InteropServices.COMException
           System.DirectoryServices.DirectoryServicesCOMException

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
COMException メンバ
System.Runtime.InteropServices 名前空間
Exception
その他の技術情報
例外の処理とスロー