Path.GetPathRoot メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| GetPathRoot(String) |
指定した文字列に含まれるパスからルート ディレクトリ情報を取得します。 |
| GetPathRoot(ReadOnlySpan<Char>) |
指定した文字スパンに含まれるパスからルート ディレクトリ情報を取得します。 |
GetPathRoot(String)
- ソース:
- Path.Unix.cs
- ソース:
- Path.Unix.cs
- ソース:
- Path.Unix.cs
- ソース:
- Path.Unix.cs
- ソース:
- Path.Unix.cs
指定した文字列に含まれるパスからルート ディレクトリ情報を取得します。
public:
static System::String ^ GetPathRoot(System::String ^ path);
public static string GetPathRoot(string path);
public static string? GetPathRoot(string? path);
static member GetPathRoot : string -> string
Public Shared Function GetPathRoot (path As String) As String
パラメーター
- path
- String
ルート ディレクトリ情報の取得元のパスを含む文字列。
返品
ルート化されている場合は、 path のルート ディレクトリ。
-又は-
Empty
pathにルート ディレクトリ情報が含まれていない場合は #。
-又は-
null
pathがnullまたは実質的に空の場合。
例外
.NET Framework および .NET Core バージョン 2.1 より前: path には、 GetInvalidPathChars()で定義されている無効な文字が 1 つ以上含まれています。
-又は-
.NET Framework のみ: Empty が pathに渡されました。
例
次の例では、 GetPathRoot メソッドの使用方法を示します。
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:\'
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:\'
注釈
このメソッドは、パスまたはファイルが存在することを確認しません。
このメソッドは、ディレクトリ区切り記号を正規化します。
次の場合、文字列は "実質的に空" です。
- Windows では、この文字列で
IsEmptyを呼び出すとtrueが返されるか、そのすべての文字がスペース (' ') になります。 - Unix では、この文字列で IsNullOrEmpty を呼び出すと、
trueが返されます。
このメソッドによって返される文字列に使用できるパターンは次のとおりです。
null(pathは null または空の文字列でした)。空の文字列 (
path現在のドライブまたはボリュームの相対パスを指定しました)。"/" (Unix:
path現在のドライブの絶対パスを指定しました)。"X:" (Windows:
pathドライブの相対パスを指定しました。 X はドライブまたはボリューム文字を表します)。"X:\" (Windows:
path特定のドライブに絶対パスを指定しました)。"\\ComputerName\SharedFolder" (Windows: UNC パス)。
"\\?\C:" (Windows: .NET バージョンおよび .NET Framework 4.6.2 以降のバージョンでサポートされている DOS デバイス パス)。
Windows 上のファイル パスの詳細については、「Windows システムのファイル パス形式」を参照してください。 一般的な I/O タスクの一覧については、「 一般的な I/O タスク」を参照してください。
こちらもご覧ください
適用対象
GetPathRoot(ReadOnlySpan<Char>)
- ソース:
- Path.Unix.cs
- ソース:
- Path.Unix.cs
- ソース:
- Path.Unix.cs
- ソース:
- Path.Unix.cs
- ソース:
- Path.Unix.cs
指定した文字スパンに含まれるパスからルート ディレクトリ情報を取得します。
public:
static ReadOnlySpan<char> GetPathRoot(ReadOnlySpan<char> path);
public static ReadOnlySpan<char> GetPathRoot(ReadOnlySpan<char> path);
static member GetPathRoot : ReadOnlySpan<char> -> ReadOnlySpan<char>
Public Shared Function GetPathRoot (path As ReadOnlySpan(Of Char)) As ReadOnlySpan(Of Char)
パラメーター
- path
- ReadOnlySpan<Char>
ルート ディレクトリ情報を取得するパスを含む文字の読み取り専用スパン。
返品
pathのルート ディレクトリを含む文字の読み取り専用スパン。
注釈
このメソッドは、パスまたはファイルが存在することを確認しません。
文字列オーバーロードとは異なり、このメソッドはディレクトリ区切り記号を正規化しません。
次の場合、 ReadOnlySpan<System.Char> は "実質的に空" になります。
- Windows では、このスパンの文字で ReadOnlySpan<T>.IsEmpty を呼び出すと、
trueが返されるか、そのすべての文字がスペース (' ') になります。 - Unix では、このスパンの文字で ReadOnlySpan<T>.IsEmpty を呼び出すと、
trueが返されます。
このメソッドによって返される読み取り専用文字スパンで使用できるパターンは次のとおりです。
ReadOnlySpan<T>.Empty (
pathは ReadOnlySpan<T>.Emptyされました。ReadOnlySpan<T>.Empty (
path現在のドライブまたはボリュームの相対パスを指定しました)。"/" (Unix:
path現在のドライブの絶対パスを指定しました)。"X:" (Windows:
pathドライブの相対パスを指定しました。 X はドライブまたはボリューム文字を表します)。"X:\" (Windows:
path特定のドライブに絶対パスを指定しました)。"\\ComputerName\SharedFolder" (Windows: UNC パス)。
"\\?\C:" (Windows: .NET バージョンおよび .NET Framework 4.6.2 以降のバージョンでサポートされている DOS デバイス パス)。
Windows 上のファイル パスの詳細については、「Windows システムのファイル パス形式」を参照してください。 一般的な I/O タスクの一覧については、「 一般的な I/O タスク」を参照してください。