Path.GetFullPath メソッド
指定したパス文字列の絶対パスを返します。
Public Shared Function GetFullPath( _
ByVal path As String _) As String
[C#]
public static string GetFullPath(stringpath);
[C++]
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 は、現在のディレクトリの絶対パスを返します。
ショート ファイル名で渡すと、長いファイル名に拡張されません。
このメソッドの使用例については、以下の「使用例」を参照してください。その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。
| 実行するタスク | 参考例があるトピック |
|---|---|
| テキスト ファイルを作成する。 | ファイルへのテキストの書き込み |
| テキスト ファイルに書き込む。 | ファイルへのテキストの書き込み |
| テキスト ファイルから読み取る。 | ファイルからのテキストの読み取り |
| ファイルの拡張子を取得する。 | GetExtension |
| パスからファイル名だけを取得する。 | GetFileNameWithoutExtension |
| パスからディレクトリ名だけを取得する。 | GetDirectoryName |
| ファイルの拡張子を変更する。 | ChangeExtension |
| ディレクトリ内のファイルをサイズ順に並べ替える。 | GetFileSystemInfos |
| ディレクトリが存在するかどうかを判別する。 | Exists |
| ファイルが存在するかどうかを判別する。 | Exists |
使用例
[Visual Basic, C#, C++] Windows ベースのデスクトップ プラットフォーム上で GetFullPath メソッドを使用する例を次に示します。
Dim fileName As String = "myfile.ext"
Dim pathname As String = "\mydir\"
Dim fullPath As String
fullPath = Path.GetFullPath(pathname)
Console.WriteLine("GetFullPath('{0}') returns '{1}'", pathname, fullPath)
fullPath = Path.GetFullPath(fileName)
Console.WriteLine("GetFullPath('{0}') returns '{1}'", fileName, fullPath)
[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);
[C++]
String * fileName = S"myfile.ext";
String * path = S"\\mydir\\";
String * fullPath;
fullPath = Path::GetFullPath(path);
Console::WriteLine(S"GetFullPath('{0}') returns '{1}'",
path, fullPath);
fullPath = Path::GetFullPath(fileName);
Console::WriteLine(S"GetFullPath('{0}') returns '{1}'",
fileName, fullPath);
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
.NET Framework セキュリティ:
- FileIOPermission 。 FileIOPermissionAccess.PathDiscovery (関連する列挙体)
参照
Path クラス | Path メンバ | System.IO 名前空間 | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み