次の方法で共有


Path.GetPathRoot メソッド

定義

オーバーロード

名前 説明
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 pathnullまたは実質的に空の場合。

例外

.NET Framework および .NET Core バージョン 2.1 より前: path には、 GetInvalidPathChars()で定義されている無効な文字が 1 つ以上含まれています。

-又は-

.NET Framework のみ: Emptypathに渡されました。

次の例では、 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 (pathReadOnlySpan<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 タスク」を参照してください。

こちらもご覧ください

適用対象