PathTooLongException クラス

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

ソース:

PathTooLongException.cs

パス名または完全修飾ファイル名がシステム定義の最大長を超えている場合にスローされる例外。

public ref class PathTooLongException : System::IO::IOException

public class PathTooLongException : System.IO.IOException

type PathTooLongException = class
    inherit IOException

Public Class PathTooLongException
Inherits IOException

継承

Object

Exception

SystemException

IOException

PathTooLongException

注釈

.NET Framework 4.6.2 より前のバージョンの.NET Frameworkで実行されるアプリでは、Windows オペレーティング システムとの互換性を維持するために、完全なパスが 260 文字を超えてはなりません。 260 文字を超えるパスでは、 が自動的にスローされます PathTooLongException。 この制限の詳細については、BCL チームブログ の「.NET の長いパス 」のエントリを参照してください。

注意

この例外は 、.NET for Windows ストア アプリ や ポータブル クラス ライブラリには含まれませんが、一部のメンバーによってスローされます。 その場合に例外をキャッチするには、代わりに を catch 処理する ステートメントを IOException 記述します。

.NET Framework 4.6.2 で実行されているアプリ以降、.NET Frameworkは 260 文字 (または MAX_PATH) を超える長いパスをサポートしています。 例外がスローされるPathTooLongException条件は、アプリがターゲットとする.NET Frameworkのバージョンによって異なります。

.NET Framework 4.6.2 以降のバージョンを対象とするアプリの長いパスは、既定でサポートされています。 ランタイムは、次の条件下で を PathTooLongException スローします。

• オペレーティング システムが COR_E_PATHTOOLONG またはそれと同等のものを返す。

• パスの長さが (32,767) 文字を超 Int16.MaxValue えています。

.NET Framework 4.6.1 以前のバージョンを対象とするアプリの長いパスは既定で無効になり、レガシ動作は維持されます。 ランタイムは、パスが PathTooLongException 260 文字を超えるたびに をスローします。

これが望ましくない場合は、.NET Framework 4.6.1 以前を対象としているが、.NET Framework 4.6.2 で実行されているアプリは、アプリケーション構成ファイルの runtime> 要素に<次の設定を含めることで、長いパスのサポートを有効にすることができます。

<runtime>
   <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" />
</runtime>

PathTooLongException は HRESULT COR_E_PATHTOOLONGを使用します。この値は0x800700CE。

コンストラクター

PathTooLongException()	HRESULT を COR_E_PATHTOOLONG に設定して、PathTooLongException クラスの新しいインスタンスを初期化します。
PathTooLongException(SerializationInfo, StreamingContext)	古い. 指定したシリアル化とコンテキスト情報を使用して、PathTooLongException クラスの新しいインスタンスを初期化します。
PathTooLongException(String)	メッセージ文字列を message に設定し、HRESULT を COR_E_PATHTOOLONG に設定して、PathTooLongException クラスの新しいインスタンスを初期化します。
PathTooLongException(String, Exception)	指定したエラー メッセージおよびこの例外の原因となった内部例外への参照を使用して、PathTooLongException クラスの新しいインスタンスを初期化します。

プロパティ

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

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetBaseException()	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の根本原因である Exception を返します。 (継承元 Exception)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetObjectData(SerializationInfo, StreamingContext)	古い. 派生クラスでオーバーライドされた場合は、その例外に関する情報を使用して SerializationInfo を設定します。 (継承元 Exception)
GetType()	現在のインスタンスのランタイム型を取得します。 (継承元 Exception)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在の例外の文字列形式を作成して返します。 (継承元 Exception)

イベント

SerializeObjectState

古い. 例外がシリアル化され、例外に関するシリアル化されたデータを含む例外状態オブジェクトが作成されたときに発生します。 (継承元 Exception)

こちらもご覧ください

• Exception
• .NET での例外の処理とスロー
• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み