Win32Exception

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

Win32Exception クラス

Win32 エラー コードの例外がスローされます。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class Win32Exception
    Inherits ExternalException
    Implements ISerializable

Visual Basic (使用法)

Dim instance As Win32Exception

C#

[SerializableAttribute] 
public class Win32Exception : ExternalException,
 ISerializable

C++

[SerializableAttribute] 
public ref class Win32Exception : public
 ExternalException, ISerializable

J#

/** @attribute SerializableAttribute() */ 
public class Win32Exception extends ExternalException
 implements ISerializable

JScript

SerializableAttribute 
public class Win32Exception extends
 ExternalException implements ISerializable

解説

Win32 エラー コードは、表示されるときに数値表現からシステム メッセージへと変換されます。この例外に関連付けられているエラー コードの数値表現にアクセスするには、NativeErrorCode を使用します。エラー コードの詳細については、http://msdn.microsoft.com のプラットフォーム SDK ドキュメントで「Win32 Error Codes」を参照してください。

メモ
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、SharedState です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。

使用例

Win32 の例外をキャッチし、その内容を解釈する方法を次のコード例に示します。この例では、存在しない実行可能ファイルを起動するため、Win32 の例外が発生します。例外をキャッチしたときに、この例では、それぞれのエラー メッセージ、エラー コード、および例外の発生源をフェッチします。

Visual Basic

Try
    Dim myProc As New System.Diagnostics.Process()
    myProc.StartInfo.FileName = "c:\nonexist.exe"
  'Attempting to start a non-existing executable
    myProc.Start()    'Start the application and assign it to the process
 component.    

Catch w As System.ComponentModel.Win32Exception
    Console.WriteLine(w.Message)
    Console.WriteLine(w.ErrorCode.ToString())
    Console.WriteLine(w.NativeErrorCode.ToString())
    Console.WriteLine(w.StackTrace)
    Console.WriteLine(w.Source)
    Dim e As New Exception()
    e = w.GetBaseException()
    Console.WriteLine(e.Message)
End Try

C#

try {
System.Diagnostics.Process myProc = new System.Diagnostics.Process();
myProc.StartInfo.FileName = "c:\nonexist.exe";  //Attempting
 to start a non-existing executable
myProc.Start();    //Start the application and assign it to the process
 component.    
}
  catch(Win32Exception w) {
Console.WriteLine(w.Message);
Console.WriteLine(w.ErrorCode.ToString());
Console.WriteLine(w.NativeErrorCode.ToString());
Console.WriteLine(w.StackTrace);
Console.WriteLine(w.Source);
Exception e=w.GetBaseException();
Console.WriteLine(e.Message);
 }

C++

try
{
   System::Diagnostics::Process^ myProc = gcnew System::Diagnostics::Process;
   //Attempting to start a non-existing executable
   myProc->StartInfo->FileName = "c:\nonexist.exe";
   //Start the application and assign it to the process component.
   myProc->Start();
}
catch ( Win32Exception^ w ) 
{
   Console::WriteLine( w->Message );
   Console::WriteLine( w->ErrorCode );
   Console::WriteLine( w->NativeErrorCode );
   Console::WriteLine( w->StackTrace );
   Console::WriteLine( w->Source );
   Exception^ e = w->GetBaseException();
   Console::WriteLine( e->Message );
}

継承階層

System.Object
   System.Exception
     System.SystemException
       System.Runtime.InteropServices.ExternalException
        System.ComponentModel.Win32Exception
           System.Net.HttpListenerException
           System.Net.NetworkInformation.NetworkInformationException
           System.Net.Sockets.SocketException

スレッド セーフ

この型の 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、1.0

参照

関連項目
Win32Exception メンバ
System.ComponentModel 名前空間

Win32Exception コンストラクタ ()

最後に発生した Win32 エラーを使用して、Win32Exception クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New Win32Exception

C#

public Win32Exception ()

C++

public:
Win32Exception ()

J#

public Win32Exception ()

JScript

public function Win32Exception ()

解説

エラーの詳細説明は、そのエラーに関連付けられている Win32 エラー メッセージによって決定されます。

このコンストラクタは、Marshal の GetLastWin32Error メソッドを使用してエラー コードを取得します。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードへのアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

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、1.0

参照

関連項目
Win32Exception クラス
Win32Exception メンバ
System.ComponentModel 名前空間

Win32Exception コンストラクタ (Int32)

指定したエラーを使用して、Win32Exception クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    error As Integer _
)

Visual Basic (使用法)

Dim error As Integer

Dim instance As New Win32Exception(error)

C#

public Win32Exception (
    int error
)

C++

public:
Win32Exception (
    int error
)

J#

public Win32Exception (
    int error
)

JScript

public function Win32Exception (
    error : int
)

パラメータ

error

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

解説

エラーの詳細説明は、そのエラーに関連付けられている Win32 エラー メッセージによって決定されます。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードへのアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

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、1.0

参照

関連項目
Win32Exception クラス
Win32Exception メンバ
System.ComponentModel 名前空間

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

指定したエラーと詳細説明を使用して、Win32Exception クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    error As Integer, _
    message As String _
)

Visual Basic (使用法)

Dim error As Integer
Dim message As String

Dim instance As New Win32Exception(error,
 message)

C#

public Win32Exception (
    int error,
    string message
)

C++

public:
Win32Exception (
    int error, 
    String^ message
)

J#

public Win32Exception (
    int error, 
    String message
)

JScript

public function Win32Exception (
    error : int, 
    message : String
)

パラメータ

error

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

message

エラーの詳細説明。

解説

エラーの詳細説明は、そのエラーに関連付けられている Win32 エラー メッセージによって決定されます。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードへのアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

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、1.0

参照

関連項目
Win32Exception クラス
Win32Exception メンバ
System.ComponentModel 名前空間

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

指定したコンテキスト情報とシリアル化情報で、Win32Exception クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.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 Win32Exception(info,
 context)

C#

protected Win32Exception (
    SerializationInfo info,
    StreamingContext context
)

C++

protected:
Win32Exception (
    SerializationInfo^ info, 
    StreamingContext context
)

J#

protected Win32Exception (
    SerializationInfo info, 
    StreamingContext context
)

JScript

protected function Win32Exception (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info

この例外に関連付けられた SerializationInfo。

context

この例外のコンテキストを表す StreamingContext オブジェクト。

.NET Framework のセキュリティ

• CodeAccessPermission  (アンマネージ コードへのアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

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

参照

関連項目
Win32Exception クラス
Win32Exception メンバ
System.ComponentModel 名前空間

Win32Exception コンストラクタ (String)

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

詳細説明を指定して、Win32Exception クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    message As String _
)

Visual Basic (使用法)

Dim message As String

Dim instance As New Win32Exception(message)

C#

public Win32Exception (
    string message
)

C++

public:
Win32Exception (
    String^ message
)

J#

public Win32Exception (
    String message
)

JScript

public function Win32Exception (
    message : String
)

パラメータ

message

エラーの詳細説明。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードへのアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

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

参照

関連項目
Win32Exception クラス
Win32Exception メンバ
System.ComponentModel 名前空間

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

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

詳細説明と例外を指定して、Win32Exception クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    message As String, _
    innerException As Exception _
)

Visual Basic (使用法)

Dim message As String
Dim innerException As Exception

Dim instance As New Win32Exception(message,
 innerException)

C#

public Win32Exception (
    string message,
    Exception innerException
)

C++

public:
Win32Exception (
    String^ message, 
    Exception^ innerException
)

J#

public Win32Exception (
    String message, 
    Exception innerException
)

JScript

public function Win32Exception (
    message : String, 
    innerException : Exception
)

パラメータ

message

エラーの詳細説明。

innerException

この例外の原因である内部例外への参照。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードへのアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

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

参照

関連項目
Win32Exception クラス
Win32Exception メンバ
System.ComponentModel 名前空間

Win32Exception コンストラクタ

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

名前	説明
Win32Exception ()	最後に発生した Win32 エラーを使用して、Win32Exception クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
Win32Exception (Int32)	指定したエラーを使用して、Win32Exception クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
Win32Exception (String)	詳細説明を指定して、Win32Exception クラスの新しいインスタンスを初期化します。
Win32Exception (Int32, String)	指定したエラーと詳細説明を使用して、Win32Exception クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
Win32Exception (SerializationInfo, StreamingContext)	指定したコンテキスト情報とシリアル化情報で、Win32Exception クラスの新しいインスタンスを初期化します。
Win32Exception (String, Exception)	詳細説明と例外を指定して、Win32Exception クラスの新しいインスタンスを初期化します。

参照

関連項目

Win32Exception クラス
Win32Exception メンバ
System.ComponentModel 名前空間

Win32Exception プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

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

プロテクト プロパティ

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 ( Exception から継承されます。)

参照

関連項目

Win32Exception クラス
System.ComponentModel 名前空間

Win32Exception メソッド

パブリック メソッド

( プロテクト メソッド も参照)

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

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

Win32Exception クラス
System.ComponentModel 名前空間

Win32Exception メンバ

Win32 エラー コードの例外がスローされます。

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

パブリック コンストラクタ

( プロテクト コンストラクタ も参照)

	名前	説明
	Win32Exception	オーバーロードされます。 Win32Exception クラスの新しいインスタンスを初期化します。

プロテクト コンストラクタ

	名前	説明
	Win32Exception	オーバーロードされます。 Win32Exception クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	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	オーバーライドされます。 ファイル名とこの Win32Exception が発生する行番号を使用して、SerializationInfo オブジェクトを設定します。
	GetType	現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

Win32Exception クラス
System.ComponentModel 名前空間