Path.GetFullPath メソッド

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

Path.GetFullPath メソッド

指定したパス文字列の絶対パスを返します。

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

Visual Basic (宣言)

Public Shared Function GetFullPath
 ( _
    path As String _
) As String

Visual Basic (使用法)

Dim path As String
Dim returnValue As String

returnValue = Path.GetFullPath(path)

C#

public static string GetFullPath
 (
    string path
)

C++

public:
static String^ GetFullPath (
    String^ path
)

J#

public static String GetFullPath (
    String path
)

JScript

public static function GetFullPath
 (
    path : String
) : String

パラメータ

path

絶対パス情報を取得する対象のファイルまたはディレクトリ。

戻り値
"C:\MyFile.txt" など、path の絶対位置を含む文字列。

例外

例外の種類	条件
ArgumentException	path が、長さが 0 の文字列であるか、空白しか含んでいないか、InvalidPathChars で定義されている無効な文字を 1 つ以上含んでいるか、またはワイルドカード文字が含まれています。 または システムは、絶対パスを取得できませんでした。
SecurityException	呼び出し元に、必要なアクセス許可がありません。
ArgumentNullException	path が null 参照 (Visual Basic では Nothing) です。
NotSupportedException	path にコロン (":") が含まれています。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。

解説

.NET Framework では、"\\.\PHYSICALDRIVE0" など、デバイス名を指定したパスを使用して物理ディスクに直接アクセスすることはできません。

絶対パスには、システムのファイルまたはディレクトリを検索するために必要な、すべての情報が含まれています。

path で指定したファイルまたはディレクトリは、存在する必要はありません。たとえば、c:\temp\newdir が現在のディレクトリの場合は、test.txt などのファイル名で GetFullPath を呼び出すと、c:\temp\newdir\test.txt が返されます。このファイルは存在する必要はありません。

ただし、path が存在する場合、呼び出し元は path のパス情報を取得するためのアクセス許可を持つ必要があります。Path クラスのほとんどのメンバと異なり、このメソッドはファイル システムにアクセスします。

このメソッドは、現在のディレクトリと現在のボリュームの情報を使用して、path を完全に限定します。path にファイル名だけを指定すると、GetFullPath は、現在のディレクトリの絶対パスを返します。

ショート ファイル名で渡すと、長いファイル名に拡張されません。

パスに有意な文字が含まれていない場合、1 つ以上の "." 文字の後に空白が続いている場合 ("." または ".." として解析されます) を除いて、パスは無効になります。

このメソッドの使用例については、以下の「使用例」を参照してください。その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキスト ファイルを作成する。	方法 : ファイルにテキストを書き込む
テキスト ファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキスト ファイルから読み取る。	方法 : ファイルからテキストを読み取る
ファイルの拡張子を取得する。	GetExtension
パスからファイル名だけを取得する。	GetFileNameWithoutExtension
パスからディレクトリ名だけを取得する。	GetDirectoryName
ファイルの拡張子を変更する。	ChangeExtension
ディレクトリ内のファイルをサイズ順に並べ替える。	GetFileSystemInfos
ディレクトリが存在するかどうかを判別する。	Exists
ファイルが存在するかどうかを判別する。	Exists

使用例

Windows ベースのデスクトップ プラットフォーム上で GetFullPath メソッドを使用するコード例を次に示します。

Visual Basic

Dim fileName As string =
 "myfile.ext"
Dim path1 As string = "mydir"
Dim path2 As string = "\mydir"
Dim fullPath As string

fullPath = Path.GetFullPath(path1)
Console.WriteLine("GetFullPath('{0}') returns '{1}'", _
    path1, fullPath)

fullPath = Path.GetFullPath(fileName)
Console.WriteLine("GetFullPath('{0}') returns '{1}'", _
    fileName, fullPath)

fullPath = Path.GetFullPath(path2)
Console.WriteLine("GetFullPath('{0}') returns '{1}'", _
    path2, fullPath)

' Output is based on your current directory, except
' in the last case, where it is based on the root drive
' GetFullPath('mydir') returns 'C:\temp\Demo\mydir'
' GetFullPath('myfile.ext') returns 'C:\temp\Demo\myfile.ext'
' GetFullPath('\mydir') returns 'C:\mydir'

C#

string fileName = "myfile.ext";
string path1 = @"mydir";
string path2 = @"\mydir";
string fullPath;

fullPath = Path.GetFullPath(path1);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
    path1, fullPath);

fullPath = Path.GetFullPath(fileName);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
    fileName, fullPath);

fullPath = Path.GetFullPath(path2);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
    path2, fullPath);

// Output is based on your current directory, except
// in the last case, where it is based on the root drive
// GetFullPath('mydir') returns 'C:\temp\Demo\mydir'
// GetFullPath('myfile.ext') returns 'C:\temp\Demo\myfile.ext'
// GetFullPath('\mydir') returns 'C:\mydir'

C++

String^ fileName = "myfile.ext";
String^ path = "\\mydir\\";
String^ fullPath;
fullPath = Path::GetFullPath( path );
Console::WriteLine( "GetFullPath('{0}') returns '{1}'", path, fullPath
 );
fullPath = Path::GetFullPath( fileName );
Console::WriteLine( "GetFullPath('{0}') returns '{1}'", fileName, fullPath
 );

J#

String fileName = "myfile.ext";
String path = "\\mydir\\";
String fullPath;

fullPath = Path.GetFullPath(path);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
    path, fullPath);

fullPath = Path.GetFullPath(fileName);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
    fileName, fullPath);

JScript

var fileName : String = "myfile.ext";
var path : String = "\\mydir\\";
var fullPath : String;

fullPath = Path.GetFullPath(path);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
                  path, fullPath);

fullPath = Path.GetFullPath(fileName);
Console.WriteLine("GetFullPath('{0}') returns '{1}'", 
                  fileName, fullPath);

.NET Framework のセキュリティ

• FileIOPermission  (パスにアクセスするために必要なアクセス許可)。FileIOPermissionAccess.PathDiscovery (関連する列挙体)

プラットフォーム

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

参照

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