Path.GetPathRoot 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

GetPathRoot(String)	從指定字串包含的路徑中取得根目錄資訊。
GetPathRoot(ReadOnlySpan<Char>)	從所指定字元範圍中包含的路徑取得根目錄資訊。

GetPathRoot(String)

來源:

Path.Unix.cs

從指定字串包含的路徑中取得根目錄資訊。

public:
 static System::String ^ GetPathRoot(System::String ^ path);

public static string? GetPathRoot (string? path);

static member GetPathRoot : string -> string

Public Shared Function GetPathRoot (path As String) As String

參數

path

String

字串，其包含從中取得根目錄資訊的路徑。

傳回

String

path 的根目錄 (如果其為根目錄)。

-或-

如果 path 不包含根目錄資訊，則為 Empty。

-或-

如果 path 為 null 或實際上是空的，則為 null。

例外狀況

ArgumentException

.NET Framework 和 2.1 之前的 .NET Core 版本：path包含中GetInvalidPathChars()定義的一或多個無效字元。

-或-

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

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回 。

此方法傳回之字串的可能模式如下：

• nullpath (為 null 或空字串) 。

• 空字串 (path 指定目前磁碟驅動器或磁碟區) 的相對路徑。

• “/” (Unix： path 在目前磁碟驅動器上指定絕對路徑) 。

• “X：” (Windows： path 在磁碟驅動器上指定相對路徑，其中 X 代表磁碟驅動器或磁碟區字母) 。

• “X：\” (Windows： path 在指定的磁碟驅動器上指定絕對路徑) 。

• “\\ComputerName\SharedFolder” (Windows：UNC 路徑) 。

• “\\？\C：” (Windows：.NET Core 1.1 和更新版本中支援的 DOS 裝置路徑，以及 .NET Framework 4.6.2 和更新版本) 。

如需 Windows 上檔案路徑的詳細資訊，請參閱 Windows 系統上的檔案路徑格式。 如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• Windows 系統上的檔案路徑格式
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案

GetPathRoot(ReadOnlySpan<Char>)

來源:

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>

字元的唯讀範圍，其包含從中取得根目錄資訊的路徑。

傳回

ReadOnlySpan<Char>

字元的唯讀範圍，其包含 path 的根目錄。

備註

這個方法不會驗證路徑或檔案是否存在。

不同於字串多載，這個方法不會正規化目錄分隔符。

ReadOnlySpan<System.Char>如果：

• 在 Windows 中，在此字元範圍上呼叫 ReadOnlySpan<T>.IsEmpty 會 true傳回 ，或其所有字元都是空格 (' ') 。
• 在 Unix 中，在此字元範圍上呼叫 ReadOnlySpan<T>.IsEmpty 會傳 true回 。

此方法傳回之唯讀字元範圍的可能模式如下：

• ReadOnlySpan<T>.Emptypath (為 ReadOnlySpan<T>.Empty。

• ReadOnlySpan<T>.Emptypath (指定目前磁碟驅動器或磁碟區) 上的相對路徑。

• “/” (Unix： path 在目前磁碟驅動器上指定絕對路徑) 。

• “X：” (Windows： path 在磁碟驅動器上指定相對路徑，其中 X 代表磁碟驅動器或磁碟區字母) 。

• “X：\” (Windows： path 在指定的磁碟驅動器上指定絕對路徑) 。

• “\\ComputerName\SharedFolder” (Windows：UNC 路徑) 。

• “\\？\C：” (Windows：.NET Core 1.1 和更新版本中支援的 DOS 裝置路徑，以及 .NET Framework 4.6.2 和更新版本) 。

如需 Windows 上檔案路徑的詳細資訊，請參閱 Windows 系統上的檔案路徑格式。 如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• Windows 系統上的檔案路徑格式