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
その他の技術情報
例外の処理とスロー

COMException コンストラクタ ()

COMException クラスの新しいインスタンスを既定値で初期化します。

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

Visual Basic (宣言)
Public Sub New
Visual Basic (使用法)
Dim instance As New COMException
C#
public COMException ()
C++
public:
COMException ()
J#
public COMException ()
JScript
public function COMException ()
解説解説

COMException は ExternalException から継承します。このコンストラクタがどのようにして Exception オブジェクトのプロパティを設定するかを次の表に示します。

プロパティ

値

InnerException

null 参照 (Visual Basic では Nothing).

Message

ローカライズされたエラー メッセージ文字列。

プラットフォームプラットフォーム

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 クラス
COMException メンバ
System.Runtime.InteropServices 名前空間

COMException コンストラクタ (SerializationInfo, StreamingContext)

シリアル化データから、COMException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Protected Sub New ( _
    info As SerializationInfo, _
    context As StreamingContext _
)
Visual Basic (使用法)
Dim info As SerializationInfo
Dim context As StreamingContext

Dim instance As New COMException(info,
 context)
C#
protected COMException (
    SerializationInfo info,
    StreamingContext context
)
C++
protected:
COMException (
    SerializationInfo^ info, 
    StreamingContext context
)
J#
protected COMException (
    SerializationInfo info, 
    StreamingContext context
)
JScript
protected function COMException (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info

シリアル化されたオブジェクト データを保持する SerializationInfo オブジェクト。

context

転送元または転送先に関するコンテキスト情報を提供する StreamingContext オブジェクト。

例外例外
例外の種類条件

ArgumentNullException

info が null 参照 (Visual Basic では Nothing) です。

解説解説

このコンストラクタは、逆シリアル化中に、ストリームで送信された例外オブジェクトを再構築するために呼び出されます。詳細については、「XML シリアル化および SOAP シリアル化」を参照してください。

COMException は ExternalException から継承します。

プラットフォームプラットフォーム

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、1.1、1.0
参照参照
関連項目
COMException クラス
COMException メンバ
System.Runtime.InteropServices 名前空間
ExternalException

COMException コンストラクタ (String, Exception)

指定したエラー メッセージと、この例外の原因である内部例外への参照を使用して、COMException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    message As String, _
    inner As Exception _
)
Visual Basic (使用法)
Dim message As String
Dim inner As Exception

Dim instance As New COMException(message,
 inner)
C#
public COMException (
    string message,
    Exception inner
)
C++
public:
COMException (
    String^ message, 
    Exception^ inner
)
J#
public COMException (
    String message, 
    Exception inner
)
JScript
public function COMException (
    message : String, 
    inner : Exception
)

パラメータ

message

例外の原因を説明するエラー メッセージ。

inner

現在の例外の原因である例外。inner パラメータが null 参照 (Visual Basic では Nothing) でない場合は、内部例外を処理する catch ブロックで現在の例外が発生します。

解説解説

前の例外の直接の結果としてスローされる例外については、InnerException プロパティに、前の例外への参照が格納されます。InnerException プロパティは、コンストラクタに渡されたものと同じ値を返します。InnerException プロパティによって内部例外値がコンストラクタに渡されなかった場合は、null 参照 (Visual Basic では Nothing) を返します。

このコンストラクタがどのようにして Exception オブジェクトのプロパティを設定するかを次の表に示します。

プロパティ

値

InnerException

内部例外参照。

Message

エラー メッセージ文字列。

プラットフォームプラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
COMException クラス
COMException メンバ
System.Runtime.InteropServices 名前空間
Exception
その他の技術情報
例外の処理とスロー

COMException コンストラクタ (String)

メッセージを指定して、COMException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    message As String _
)
Visual Basic (使用法)
Dim message As String

Dim instance As New COMException(message)
C#
public COMException (
    string message
)
C++
public:
COMException (
    String^ message
)
J#
public COMException (
    String message
)
JScript
public function COMException (
    message : String
)

パラメータ

message

例外の理由を示すメッセージ。

解説解説

COMException は ExternalException から継承します。このコンストラクタがどのようにして Exception オブジェクトのプロパティを設定するかを次の表に示します。

プロパティ

値

InnerException

null 参照 (Visual Basic では Nothing)

Message

message

プラットフォームプラットフォーム

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 クラス
COMException メンバ
System.Runtime.InteropServices 名前空間

COMException コンストラクタ

COMException クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
COMException () COMException クラスの新しいインスタンスを既定値で初期化します。

.NET Compact Framework によってサポートされています。

COMException (String) メッセージを指定して、COMException クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

COMException (SerializationInfo, StreamingContext) シリアル化データから、COMException クラスの新しいインスタンスを初期化します。
COMException (String, Exception) 指定したエラー メッセージと、この例外の原因である内部例外への参照を使用して、COMException クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

COMException (String, Int32) 指定したメッセージとエラー コードを使用して、COMException クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

参照参照

関連項目

COMException クラス
COMException メンバ
System.Runtime.InteropServices 名前空間

COMException コンストラクタ (String, Int32)

指定したメッセージとエラー コードを使用して、COMException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)
Public Sub New ( _
    message As String, _
    errorCode As Integer _
)
Visual Basic (使用法)
Dim message As String
Dim errorCode As Integer

Dim instance As New COMException(message,
 errorCode)
C#
public COMException (
    string message,
    int errorCode
)
C++
public:
COMException (
    String^ message, 
    int errorCode
)
J#
public COMException (
    String message, 
    int errorCode
)
JScript
public function COMException (
    message : String, 
    errorCode : int
)

パラメータ

message

例外が発生した理由を示すメッセージ。

errorCode

この例外に関連付けられているエラー コード (HRESULT) 値。

解説解説

この COMException コンストラクタは、エラー コード付きの基本メッセージを設定します。

COMException は ExternalException から継承します。このコンストラクタがどのようにして Exception オブジェクトのプロパティを設定するかを次の表に示します。

プロパティ

値

InnerException

null 参照 (Visual Basic では Nothing)

Message

message

プラットフォームプラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
COMException クラス
COMException メンバ
System.Runtime.InteropServices 名前空間

COMException プロパティ


パブリック プロパティパブリック プロパティ

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

関連項目

COMException クラス
System.Runtime.InteropServices 名前空間
Exception

その他の技術情報

例外の処理とスロー

COMException メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetBaseException  派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 ( Exception から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetObjectData  派生クラスでオーバーライドされた場合は、その例外に関する情報を使用して SerializationInfo を設定します。 ( Exception から継承されます。)
パブリック メソッド GetType  現在のインスタンスのランタイム型を取得します。 ( Exception から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ToString オーバーライドされます。 例外の内容を文字列に変換します。
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
参照参照

関連項目

COMException クラス
System.Runtime.InteropServices 名前空間
Exception

その他の技術情報

例外の処理とスロー

COMException メンバ

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

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


パブリック コンストラクタパブリック コンストラクタ
( プロテクト コンストラクタ も参照)
  名前 説明
パブリック メソッド COMException オーバーロードされます。 COMException クラスの新しいインスタンスを初期化します。
プロテクト コンストラクタプロテクト コンストラクタ
  名前 説明
プロテクト メソッド COMException オーバーロードされます。 COMException クラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
( プロテクト プロパティ も参照)
  名前 説明
パブリック プロパティ Data  例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。(Exception から継承されます。)
パブリック プロパティ ErrorCode  エラーの HRESULT を取得します。(ExternalException から継承されます。)
パブリック プロパティ HelpLink  例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。(Exception から継承されます。)
パブリック プロパティ InnerException  現在の例外を発生させた Exception インスタンスを取得します。(Exception から継承されます。)
パブリック プロパティ Message  現在の例外を説明するメッセージを取得します。(Exception から継承されます。)
パブリック プロパティ Source  エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。(Exception から継承されます。)
パブリック プロパティ StackTrace  現在の例外がスローされたときにコール スタックにあったフレームの文字列形式を取得します。(Exception から継承されます。)
パブリック プロパティ TargetSite  現在の例外をスローするメソッドを取得します。(Exception から継承されます。)
プロテクト プロパティプロテクト プロパティ
  名前 説明
プロテクト プロパティ HResult  特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。(Exception から継承されます。)
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetBaseException  派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 (Exception から継承されます。)
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetObjectData  派生クラスでオーバーライドされた場合は、その例外に関する情報を使用して SerializationInfo を設定します。 (Exception から継承されます。)
パブリック メソッド GetType  現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ToString オーバーライドされます。 例外の内容を文字列に変換します。
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド Finalize  Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
プロテクト メソッド MemberwiseClone  現在の Object の簡易コピーを作成します。 (Object から継承されます。)
参照参照

関連項目

COMException クラス
System.Runtime.InteropServices 名前空間
Exception

その他の技術情報

例外の処理とスロー

急上昇のことば

右近良之
カナル
canal
missav
ホーリーシット
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「COMException」の関連用語

1
COMException コンストラクタ ()
.NET Framework クラス ライブラリ リファレンス
76% |||||

2
DirectoryServicesCOMException クラス
.NET Framework クラス ライブラリ リファレンス
58% |||||

3
COMException クラス
.NET Framework クラス ライブラリ リファレンス
50% |||||

4
Marshal.ThrowExceptionForHR メソッド
.NET Framework クラス ライブラリ リファレンス
36% |||||

5
COMException.ToString メソッド
.NET Framework クラス ライブラリ リファレンス
36% |||||

6
COMException メンバ
.NET Framework クラス ライブラリ リファレンス
34% |||||

7
IClrObjectFactory メソッド
.NET Framework クラス ライブラリ リファレンス
32% |||||

8
IClrObjectFactory メンバ
.NET Framework クラス ライブラリ リファレンス
18% |||||

9
InvalidComObjectException コンストラクタ
.NET Framework クラス ライブラリ リファレンス
18% |||||

10
ClrObjectFactory.CreateFromMailbox メソッド
.NET Framework クラス ライブラリ リファレンス
18% |||||

COMExceptionのお隣キーワード

COMException

COMException クラス

COMException コンストラクタ

COMException プロパティ

COMException メソッド

COMException メンバ

COMException.ToString メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


COMExceptionのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2024 Microsoft.All rights reserved.

©2024 GRAS Group, Inc.RSS