Path.GetPathRoot メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

Path.GetPathRoot メソッド

指定したパスのルートディレクトリ情報を取得します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim path As String
Dim returnValue As String

returnValue = Path.GetPathRoot(path)

public static string GetPathRoot
 (
    string path
)

C++

public:
static String^ GetPathRoot (
    String^ path
)

public static String GetPathRoot (
    String path
)

JScript

public static function GetPathRoot
 (
    path : String
) : String

パラメータ

path: ルートディレクトリ情報を取得する対象のパス。

戻り値
path にルートディレクトリ情報が含まれている場合は、"C:\" などのルートディレクトリを含む文字列、path が null 参照 (Visual Basic では Nothing) の場合は null 参照 (Visual Basic では Nothing)、path にルートディレクトリ情報が含まれていない場合には空の文字列。

例外

例外の種類	条件
ArgumentException	path に、InvalidPathChars で定義されている無効な文字が 1 つ以上含まれているか、ワイルドカード文字が含まれています。または String.Empty が path に渡されました。

例外の種類

条件

ArgumentException

path に、InvalidPathChars で定義されている無効な文字が 1 つ以上含まれているか、ワイルドカード文字が含まれています。

または

String.Empty が path に渡されました。

解説

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

このメソッドは、パス名またはファイル名が存在することを検査しません。

このメソッドで返される、有効な文字列のパターンは次のとおりです。

空の文字列 (path で現在のドライブまたはボリュームに対する相対パスを指定しました)。
"/" (path で現在のドライブに対する絶対パスを指定しました)。
"X:" (path は、ドライブで相対パスを指定しました。X はドライブ名またはボリューム名を表します)。
"X:/" (path は指定したドライブで絶対パスを指定しました)。

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

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

使用例

GetPathRoot メソッドの使用方法を次のコード例に示します。

Visual Basic

Dim pathname As String =
 "\mydir\"
Dim fileName As String =
 "myfile.ext"
Dim fullPath As String =
 "C:\mydir\myfile.ext"
Dim pathnameRoot As String

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

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

pathnameRoot = Path.GetPathRoot(fullPath)
Console.WriteLine("GetPathRoot('{0}') returns '{1}'", fullPath,
 pathnameRoot)

' This code produces output similar to the following:
'
' GetPathRoot('\mydir\') returns '\'
' GetPathRoot('myfile.ext') returns ''
' GetPathRoot('C:\mydir\myfile.ext') returns 'C:\'

string path = @"\mydir\";
string fileName = "myfile.ext";
string fullPath = @"C:\mydir\myfile.ext";
string pathRoot;

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

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

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

// This code produces output similar to the following:
//
// GetPathRoot('\mydir\') returns '\'
// GetPathRoot('myfile.ext') returns ''
// GetPathRoot('C:\mydir\myfile.ext') returns 'C:\'

C++

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

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

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

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

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

JScript

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

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

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

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