Path.GetPathRoot Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Aşırı Yüklemeler

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

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 "etkin 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ısı 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ü veya birim üzerinde 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, X'in bir sürücüyü veya birim harfini temsil ettiği göreli bir yol belirtti).

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

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

• "\\?\C:" (Windows: .NET Core 1.1 ve sonraki sürümlerde ve .NET Framework 4.6.2 ve sonraki sürümlerde 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 Stream G/Ç
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Bir 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ılması.

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'da, karakterlerin bu aralığında çağrısı ReadOnlySpan<T>.IsEmpty döndürür trueveya tüm karakterleri boşluk (' ') olur.
• Unix'te, karakterlerin bu aralığı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ü veya birim üzerinde 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, X'in bir sürücüyü veya birim harfini temsil ettiği göreli bir yol belirtti).

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

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

• "\\?\C:" (Windows: .NET Core 1.1 ve sonraki sürümlerde ve .NET Framework 4.6.2 ve sonraki sürümlerde 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