Path.GetPathRoot Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Aşırı Yüklemeler

Name	Description
GetPathRoot(String)	Belirtilen dizede yer alan yoldan kök dizin bilgilerini alır.
GetPathRoot(ReadOnlySpan<Char>)	Belirtilen karakter aralığında yer alan yoldan kök dizin bilgilerini alır.

GetPathRoot(String)

Kaynak:

Path.Unix.cs

Belirtilen dizede yer alan yoldan kök dizin bilgilerini alır.

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

Parametreler

path

String

Kök dizin bilgilerinin alındığı yolu içeren bir dize.

Döndürülenler

String

Kök path dizinine kök olarak yüklenmişse.

-veya-

Empty kök dizin bilgileri içermiyorsa path .

-veya-

null null veya etkin bir şekilde boşsapath.

Özel durumlar

ArgumentException

2.1'den eski .NET Framework ve .NET Core sürümleri: path içinde GetInvalidPathChars()tanımlanan geçersiz karakterlerden birini veya daha fazlasını içerir.

-veya-

Yalnızca .NET Framework: Empty öğesine pathgeçirildi.

Örnekler

Aşağıdaki örnekte yönteminin kullanımı gösterilmektedir 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:\'

Açıklamalar

Bu yöntem, yolun veya dosyanın var olduğunu doğrulamaz.

Bu yöntem dizin ayırıcılarını normalleştirir.

Dize şu durumda "etkili bir şekilde boş" olur:

• Windows'da, bu dizede çağrılması IsEmpty döndürür trueveya tüm karakterleri boşluk (' ') olur.
• Unix'te, bu dizede çağrılması IsNullOrEmpty döndürür true.

Bu yöntem tarafından döndürülen dize için olası desenler aşağıdaki gibidir:

• null (path null veya boş bir dizeydi).

• Boş bir dize (path geçerli sürücüde veya birimde göreli bir yol belirtildi).

• "/" (Unix: path geçerli sürücüde mutlak bir yol belirtti).

• "X:" (Windows: path bir sürücüde göreli bir yol belirtti; burada X bir sürücüyü veya birim harfini temsil eder).

• "X:\" (Windows: path belirli bir sürücüde mutlak bir yol belirtti).

• "\\ComputerName\SharedFolder" (Windows: unc yolu).

• "\\?\C:" (Windows: .NET sürümlerinde ve .NET Framework 4.6.2 ve sonraki sürümlerinde desteklenen bir DOS cihaz yolu).

Windows'ta dosya yolları hakkında daha fazla bilgi için bkz. Windows sistemlerinde dosya yolu biçimleri. Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

• Windows sistemlerinde dosya yolu biçimleri
• Dosya ve Akış G/Ç'si
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Dosyaya Metin Yazma

GetPathRoot(ReadOnlySpan<Char>)

Kaynak:

Path.Unix.cs

Belirtilen karakter aralığında yer alan yoldan kök dizin bilgilerini alır.

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)

Parametreler

path

ReadOnlySpan<Char>

Kök dizin bilgilerinin alındığı yolu içeren karakterlerin salt okunur yayılma alanı.

Döndürülenler

ReadOnlySpan<Char>

kök dizinini içeren karakterlerin salt okunur yayılma alanı path.

Açıklamalar

Bu yöntem, yolun veya dosyanın var olduğunu doğrulamaz.

Dize aşırı yüklemesinin aksine, bu yöntem dizin ayırıcılarını normalleştirmez.

A ReadOnlySpan<System.Char> şu durumda "etkin bir şekilde boş" olur:

• Windows'ta, bu karakter aralığında çağrı ReadOnlySpan<T>.IsEmpty yapmak döndürür trueveya tüm karakterleri boşluk (' ') olur.
• Unix'te, karakterlerin bu yayılma alanında çağrısı ReadOnlySpan<T>.IsEmpty döndürür true.

Bu yöntem tarafından döndürülen salt okunur karakter aralığı için olası desenler aşağıdaki gibidir:

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

• ReadOnlySpan<T>.Empty (path geçerli sürücüde veya birimde göreli bir yol belirtti).

• "/" (Unix: path geçerli sürücüde mutlak bir yol belirtti).

• "X:" (Windows: path bir sürücüde göreli bir yol belirtti; burada X bir sürücüyü veya birim harfini temsil eder).

• "X:\" (Windows: path belirli bir sürücüde mutlak bir yol belirtti).

• "\\ComputerName\SharedFolder" (Windows: unc yolu).

• "\\?\C:" (Windows: .NET sürümlerinde ve .NET Framework 4.6.2 ve sonraki sürümlerinde desteklenen bir DOS cihaz yolu).

Windows'ta dosya yolları hakkında daha fazla bilgi için bkz. Windows sistemlerinde dosya yolu biçimleri. Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

• Windows sistemlerinde dosya yolu biçimleri