Path.GetPathRoot メソッド

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

C#

public static string GetPathRoot
 (
    string path
)

C++

public:
static String^ GetPathRoot (
    String^ path
)

J#

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 に渡されました。

解説

.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:\'

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

J#

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

プラットフォーム

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 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む