Path.GetPathRoot Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Overload

GetPathRoot(String)	Mendapatkan informasi direktori akar dari jalur yang terkandung dalam string yang ditentukan.
GetPathRoot(ReadOnlySpan<Char>)	Mendapatkan informasi direktori akar dari jalur yang terkandung dalam rentang karakter yang ditentukan.

GetPathRoot(String)

Sumber:

Path.Unix.cs

Mendapatkan informasi direktori akar dari jalur yang terkandung dalam string yang ditentukan.

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

Parameter

path

String

String yang berisi jalur untuk mendapatkan informasi direktori akar.

Mengembalikan

String

Direktori path akar jika di-root.

-atau-

Empty jika path tidak berisi informasi direktori akar.

-atau-

null jika path kosong null atau efektif.

Pengecualian

ArgumentException

.NET Framework dan .NET Core yang lebih lama dari 2.1: path berisi satu atau beberapa karakter yang tidak valid yang ditentukan dalam GetInvalidPathChars().

-atau-

.NET Framework saja: Empty diteruskan ke path.

Contoh

Contoh berikut menunjukkan penggunaan GetPathRoot metode .

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

Keterangan

Metode ini tidak memverifikasi bahwa jalur atau file ada.

Metode ini akan menormalkan pemisah direktori.

String "secara efektif kosong" jika:

• Di Windows, panggilan IsEmpty pada string ini mengembalikan true, atau semua karakternya adalah spasi (' ').
• Di Unix, memanggil IsNullOrEmpty string ini mengembalikan true.

Kemungkinan pola untuk string yang dikembalikan oleh metode ini adalah sebagai berikut:

• null (path null atau string kosong).

• String kosong (path menentukan jalur relatif pada drive atau volume saat ini).

• "/" (Unix: path menentukan jalur absolut pada drive saat ini).

• "X:" (Windows: path menentukan jalur relatif pada drive, di mana X mewakili drive atau huruf volume).

• "X:\" (Windows: path menentukan jalur absolut pada drive tertentu).

• "\\ComputerName\SharedFolder" (Windows: jalur UNC).

• "\\?\C:" (Windows: jalur perangkat DOS, didukung di .NET Core 1.1 dan versi yang lebih baru, dan dalam .NET Framework 4.6.2 dan versi yang lebih baru).

Untuk informasi selengkapnya tentang jalur file di Windows, lihat Format jalur file pada sistem Windows. Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• Format jalur file pada sistem Windows
• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

GetPathRoot(ReadOnlySpan<Char>)

Sumber:

Path.Unix.cs

Mendapatkan informasi direktori akar dari jalur yang terkandung dalam rentang karakter yang ditentukan.

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)

Parameter

path

ReadOnlySpan<Char>

Rentang karakter baca-saja yang berisi jalur untuk mendapatkan informasi direktori akar.

Mengembalikan

ReadOnlySpan<Char>

Rentang karakter baca-saja yang berisi direktori pathakar .

Keterangan

Metode ini tidak memverifikasi bahwa jalur atau file ada.

Tidak seperti kelebihan string, metode ini tidak menormalkan pemisah direktori.

ReadOnlySpan<System.Char> A "secara efektif kosong" jika:

• Di Windows, memanggil ReadOnlySpan<T>.IsEmpty pada rentang karakter ini mengembalikan true, atau semua karakternya adalah spasi (' ').
• Di Unix, memanggil ReadOnlySpan<T>.IsEmpty rentang karakter ini mengembalikan true.

Kemungkinan pola untuk rentang karakter baca-saja yang dikembalikan oleh metode ini adalah sebagai berikut:

• ReadOnlySpan<T>.Empty (path adalah ReadOnlySpan<T>.Empty.

• ReadOnlySpan<T>.Empty (path menentukan jalur relatif pada drive atau volume saat ini).

• "/" (Unix: path menentukan jalur absolut pada drive saat ini).

• "X:" (Windows: path menentukan jalur relatif pada drive, di mana X mewakili drive atau huruf volume).

• "X:\" (Windows: path menentukan jalur absolut pada drive tertentu).

• "\\ComputerName\SharedFolder" (Windows: jalur UNC).

• "\\?\C:" (Windows: jalur perangkat DOS, didukung di .NET Core 1.1 dan versi yang lebih baru, dan dalam .NET Framework 4.6.2 dan versi yang lebih baru).

Untuk informasi selengkapnya tentang jalur file di Windows, lihat Format jalur file pada sistem Windows. Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• Format jalur file pada sistem Windows