Path.GetDirectoryName メソッド

指定したパス文字列のディレクトリ情報を返します。

Public Shared Function GetDirectoryName( _
   ByVal path As String _) As String
[C#]
public static string GetDirectoryName(stringpath);
[C++]
public: static String* GetDirectoryName(String* path);
[JScript]
public static function GetDirectoryName(
   path : String) : String;

パラメータ

• path
  ファイルまたはディレクトリのパス。

戻り値

path がルート ディレクトリを示す場合、 path または null 参照 (Visual Basic では Nothing) のディレクトリ情報を含む String は空の文字列 ("") または null 参照 (Nothing) です。 path にディレクトリ情報が含まれていない場合は、 String.Empty を返します。

例外

例外の種類	条件
ArgumentException	path に、無効な文字が含まれているか、空か、または空白だけが含まれています。

解説

このメソッドは、パス内の最後の DirectorySeparatorChar 文字または AltDirectorySeparatorChar 文字を含めずに、それよりも前にあるすべての文字で構成された文字列を返します。

パス パラメータを "c:\" に設定してこのメソッドを呼び出すと、空の文字列が返されます。なお、このメソッドは "file:" のパスをサポートしていません。

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

実行するタスク	参考例があるトピック
テキスト ファイルを作成する。	ファイルへのテキストの書き込み
テキスト ファイルに書き込む。	ファイルへのテキストの書き込み
テキスト ファイルから読み取る。	ファイルからのテキストの読み取り
ファイルの拡張子を取得する。	GetExtension
ファイルの絶対パスを取得する。	GetFullPath
パスからファイル名だけを取得する。	GetFileNameWithoutExtension
ファイルの拡張子を変更する。	ChangeExtension

使用例

[Visual Basic, C#, C++] Windows ベースのデスクトップ プラットフォーム上で GetDirectoryName メソッドを使用する例を次に示します。

 
Dim fileName As String = "C:\mydir\myfile.ext"
Dim pathname As String = "C:\mydir\"
Dim rootPath As String = "C:\"
Dim directoryName As String

directoryName = Path.GetDirectoryName(fileName)
Console.WriteLine("GetDirectoryName('{0}') returns '{1}'", fileName, directoryName)

directoryName = Path.GetDirectoryName(pathname)
Console.WriteLine("GetDirectoryName('{0}') returns '{1}'", pathname, directoryName)

directoryName = Path.GetDirectoryName(rootPath)
Console.WriteLine("GetDirectoryName('{0}') returns '{1}'", rootPath, directoryName)

[C#] 
string fileName = @"C:\mydir\myfile.ext";
string path = @"C:\mydir\";
string rootPath = @"C:\";
string directoryName;
    
directoryName = Path.GetDirectoryName(fileName);
Console.WriteLine("GetDirectoryName('{0}') returns '{1}'", 
    fileName, directoryName);

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

directoryName = Path.GetDirectoryName(rootPath);
Console.WriteLine("GetDirectoryName('{0}') returns '{1}'", 
    rootPath, directoryName);

[C++] 
String * fileName = S"C:\\mydir\\myfile.ext";
String * path = S"C:\\mydir\\";
String * rootPath = S"C:\\";
String * directoryName;

directoryName = Path::GetDirectoryName(fileName);
Console::WriteLine(S"GetDirectoryName('{0}') returns '{1}'", 
   fileName, directoryName);

directoryName = Path::GetDirectoryName(path);
Console::WriteLine(S"GetDirectoryName('{0}') returns '{1}'", 
   path, directoryName);

directoryName = Path::GetDirectoryName(rootPath);
Console::WriteLine(S"GetDirectoryName('{0}') returns '{1}'", 
   rootPath, directoryName);

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: 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

参照

Path クラス | Path メンバ | System.IO 名前空間 | 入出力操作 | ファイルからのテキストの読み取り | ファイルへのテキストの書き込み