FileNotFoundException

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

FileNotFoundException クラス

ディスク上に存在しないファイルにアクセスしようとして失敗したときにスローされる例外。

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

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class FileNotFoundException
    Inherits IOException

Visual Basic (使用法)

Dim instance As FileNotFoundException

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class FileNotFoundException : IOException

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class FileNotFoundException : public
 IOException

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class FileNotFoundException extends
 IOException

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class FileNotFoundException extends
 IOException

解説

FileNotFoundException は、値 0x80070002 の HRESULT COR_E_FILENOTFOUND を使用します。

継承階層

System.Object
   System.Exception
     System.SystemException
       System.IO.IOException
        System.IO.FileNotFoundException

スレッド セーフ

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

参照

関連項目
FileNotFoundException メンバ
System.IO 名前空間
Exception
その他の技術情報
例外の処理とスロー
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileNotFoundException コンストラクタ ()

メッセージ文字列がシステムによって提供されたメッセージに設定され、HRESULT が COR_E_FILENOTFOUND に設定された FileNotFoundException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New FileNotFoundException

C#

public FileNotFoundException ()

C++

public:
FileNotFoundException ()

J#

public FileNotFoundException ()

JScript

public function FileNotFoundException ()

解説

このコンストラクタは、新しいインスタンスの 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、1.0

参照

関連項目
FileNotFoundException クラス
FileNotFoundException メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

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

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

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.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 FileNotFoundException(message,
 innerException)

C#

public FileNotFoundException (
    string message,
    Exception innerException
)

C++

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

J#

public FileNotFoundException (
    String message, 
    Exception innerException
)

JScript

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

パラメータ

message

エラーを説明する String。message の内容は、ユーザーが読むことを前提としています。このコンストラクタの呼び出し元は、この文字列が現在のシステムのカルチャに合わせてローカライズ済みであることを確認しておく必要があります。

innerException

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

解説

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

FileNotFoundException のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	値
InnerException	内部例外参照。
Message	エラー メッセージ文字列。

内部例外の詳細については、InnerException のトピックを参照してください。

プラットフォーム

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

参照

関連項目
FileNotFoundException クラス
FileNotFoundException メンバ
System.IO 名前空間
Exception
その他の技術情報
例外の処理とスロー
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim message As String
Dim fileName As String
Dim innerException As Exception

Dim instance As New FileNotFoundException(message,
 fileName, innerException)

C#

public FileNotFoundException (
    string message,
    string fileName,
    Exception innerException
)

C++

public:
FileNotFoundException (
    String^ message, 
    String^ fileName, 
    Exception^ innerException
)

J#

public FileNotFoundException (
    String message, 
    String fileName, 
    Exception innerException
)

JScript

public function FileNotFoundException (
    message : String, 
    fileName : String, 
    innerException : Exception
)

パラメータ

message

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

fileName

無効なイメージを含むファイルの完全名を含んでいる String。

innerException

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

解説

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

FileNotFoundException のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	値
InnerException	内部例外参照。
Message	エラー メッセージ文字列。

内部例外の詳細については、InnerException のトピックを参照してください。

プラットフォーム

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

参照

関連項目
FileNotFoundException クラス
FileNotFoundException メンバ
System.IO 名前空間
Exception
その他の技術情報
例外の処理とスロー
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileNotFoundException コンストラクタ (String)

メッセージ文字列を message に設定し、HRESULT を COR_E_FILENOTFOUND に設定して、FileNotFoundException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    message As String _
)

Visual Basic (使用法)

Dim message As String

Dim instance As New FileNotFoundException(message)

C#

public FileNotFoundException (
    string message
)

C++

public:
FileNotFoundException (
    String^ message
)

J#

public FileNotFoundException (
    String message
)

JScript

public function FileNotFoundException (
    message : String
)

パラメータ

message

エラーを説明する String。message の内容は、ユーザーが読むことを前提としています。このコンストラクタの呼び出し元は、この文字列が現在のシステムのカルチャに合わせてローカライズ済みであることを確認しておく必要があります。

解説

このコンストラクタは、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、1.0

参照

関連項目
FileNotFoundException クラス
FileNotFoundException メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

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

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

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

C#

protected FileNotFoundException (
    SerializationInfo info,
    StreamingContext context
)

C++

protected:
FileNotFoundException (
    SerializationInfo^ info, 
    StreamingContext context
)

J#

protected FileNotFoundException (
    SerializationInfo info, 
    StreamingContext context
)

JScript

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

パラメータ

info

ファイルをシリアル化または逆シリアル化するためのデータ。

context

ファイルのソースとデスティネーション。

プラットフォーム

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

参照

関連項目
FileNotFoundException クラス
FileNotFoundException メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileNotFoundException コンストラクタ

オプションのメッセージ文字列と内部 Exception 参照を設定して、FileNotFoundException クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
FileNotFoundException ()	メッセージ文字列がシステムによって提供されたメッセージに設定され、HRESULT が COR_E_FILENOTFOUND に設定された FileNotFoundException クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
FileNotFoundException (String)	メッセージ文字列を message に設定し、HRESULT を COR_E_FILENOTFOUND に設定して、FileNotFoundException クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
FileNotFoundException (SerializationInfo, StreamingContext)	指定したシリアル化情報とコンテキスト情報を使用して、FileNotFoundException クラスの新しいインスタンスを初期化します。
FileNotFoundException (String, Exception)	指定したエラー メッセージと、この例外の原因である内部例外への参照を使用して、FileNotFoundException クラスの新しいインスタンスを初期化します。
FileNotFoundException (String, String)	メッセージ文字列を message に設定し、見つからなかったファイル名を指定し、HRESULT を COR_E_FILENOTFOUND に設定して、FileNotFoundException クラスの新しいインスタンスを初期化します。
FileNotFoundException (String, String, Exception)	指定したエラー メッセージと、この例外の原因である内部例外への参照を使用して、FileNotFoundException クラスの新しいインスタンスを初期化します。

参照

関連項目

FileNotFoundException クラス
FileNotFoundException メンバ
System.IO 名前空間

その他の技術情報

ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileNotFoundException コンストラクタ (String, String)

メッセージ文字列を message に設定し、見つからなかったファイル名を指定し、HRESULT を COR_E_FILENOTFOUND に設定して、FileNotFoundException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    message As String, _
    fileName As String _
)

Visual Basic (使用法)

Dim message As String
Dim fileName As String

Dim instance As New FileNotFoundException(message,
 fileName)

C#

public FileNotFoundException (
    string message,
    string fileName
)

C++

public:
FileNotFoundException (
    String^ message, 
    String^ fileName
)

J#

public FileNotFoundException (
    String message, 
    String fileName
)

JScript

public function FileNotFoundException (
    message : String, 
    fileName : String
)

パラメータ

message

エラーを説明する String。message の内容は、ユーザーが読むことを前提としています。このコンストラクタの呼び出し元は、この文字列が現在のシステムのカルチャに合わせてローカライズ済みであることを確認しておく必要があります。

fileName

無効なイメージを含むファイルの完全名を含んでいる String。

解説

コンストラクタは、新しいインスタンスの Message プロパティを message を使用して初期化し、FileName プロパティを fileName を使用して初期化します。

プラットフォーム

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

参照

関連項目
FileNotFoundException クラス
FileNotFoundException メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileNotFoundException プロパティ

パブリック プロパティ

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

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

プロテクト プロパティ

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

参照

関連項目

FileNotFoundException クラス
System.IO 名前空間
Exception

その他の技術情報

例外の処理とスロー
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileNotFoundException メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

FileNotFoundException クラス
System.IO 名前空間
Exception

その他の技術情報

例外の処理とスロー
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む

FileNotFoundException メンバ

ディスク上に存在しないファイルにアクセスしようとして失敗したときにスローされる例外。

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

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

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

	名前	説明
	FileNotFoundException	オーバーロードされます。 オプションのメッセージ文字列と内部 Exception 参照を設定して、FileNotFoundException クラスの新しいインスタンスを初期化します。

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

	名前	説明
	FileNotFoundException	オーバーロードされます。 オプションのメッセージ文字列と内部 Exception 参照を設定して、FileNotFoundException クラスの新しいインスタンスを初期化します。

パブリック プロパティ

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

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

プロテクト プロパティ

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

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

FileNotFoundException クラス
System.IO 名前空間
Exception

その他の技術情報

例外の処理とスロー
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む