PathTooLongException クラス

リファレンス

定義

名前空間:: System.IO

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

ソース:: PathTooLongException.cs

ソース:: PathTooLongException.cs

ソース:: PathTooLongException.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

public class PathTooLongException : System.IO.IOException

[System.Serializable]
public class PathTooLongException : System.IO.IOException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class PathTooLongException : System.IO.IOException

type PathTooLongException = class
    inherit IOException

[<System.Serializable>]
type PathTooLongException = class
    inherit IOException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type PathTooLongException = class
    inherit IOException

Public Class PathTooLongException
Inherits IOException

継承: Object

Exception

IOException
PathTooLongException

継承: Object

Exception

SystemException

IOException
PathTooLongException

属性: SerializableAttribute ComVisibleAttribute

注釈

.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> 要素に<次の設定を含めることで、長いパスのサポートを有効にすることができます。

XML

<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)

適用対象

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

次の方法で共有