Path.GetPathRoot Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Przeciążenia

GetPathRoot(String)	Pobiera informacje o katalogu głównym ze ścieżki zawartej w określonym ciągu.
GetPathRoot(ReadOnlySpan<Char>)	Pobiera informacje o katalogu głównym ze ścieżki zawartej w określonym zakresie znaków.

GetPathRoot(String)

Źródło:

Path.Unix.cs

Pobiera informacje o katalogu głównym ze ścieżki zawartej w określonym ciągu.

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

Parametry

path

String

Ciąg zawierający ścieżkę, z której mają być uzyskiwane informacje o katalogu głównym.

Zwraca

String

Katalog główny, path jeśli jest on rooted.

-lub-

Empty jeśli path nie zawiera informacji o katalogu głównym.

-lub-

null jeśli path jest null lub jest skutecznie pusty.

Wyjątki

ArgumentException

.NET Framework i .NET Core w wersjach starszych niż 2.1: path zawiera co najmniej jeden nieprawidłowy znak zdefiniowany w programie GetInvalidPathChars().

-lub-

.NET Framework tylko: Empty został przekazany do path.

Przykłady

W poniższym przykładzie pokazano użycie GetPathRoot metody .

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

Uwagi

Ta metoda nie sprawdza, czy ścieżka lub plik istnieje.

Ta metoda normalizuje separatory katalogów.

Ciąg jest "skutecznie pusty", jeśli:

• W systemie Windows wywołanie IsEmpty tego ciągu zwraca truewartość , lub wszystkie jego znaki to spacje (' ').
• W systemie Unix wywołanie IsNullOrEmpty tego ciągu zwraca wartość true.

Możliwe wzorce ciągu zwracanego przez tę metodę są następujące:

• null (path miał wartość null lub pusty ciąg).

• Pusty ciąg (path określono ścieżkę względną na bieżącym dysku lub woluminie).

• "/" (Unix: path określono ścieżkę bezwzględną na bieżącym dysku).

• "X:" (Windows: path określono ścieżkę względną na dysku, gdzie X reprezentuje dysk lub literę woluminu).

• "X:\" (Windows: path określono ścieżkę bezwzględną na danym dysku).

• "\\ComputerName\SharedFolder" (Windows: ścieżka UNC).

• "\\?\C:" (Windows: ścieżka urządzenia DOS obsługiwana w wersjach .NET Core 1.1 i nowszych oraz w .NET Framework 4.6.2 i nowszych wersjach).

Aby uzyskać więcej informacji na temat ścieżek plików w systemie Windows, zobacz Formaty ścieżek plików w systemach Windows. Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• Formaty ścieżek plików w systemie Windows
• Plik i Stream we/wy
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku

GetPathRoot(ReadOnlySpan<Char>)

Źródło:

Path.Unix.cs

Pobiera informacje o katalogu głównym ze ścieżki zawartej w określonym zakresie znaków.

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)

Parametry

path

ReadOnlySpan<Char>

Zakres znaków tylko do odczytu zawierający ścieżkę, z której mają być uzyskiwane informacje o katalogu głównym.

Zwraca

ReadOnlySpan<Char>

Zakres znaków tylko do odczytu zawierający katalog główny elementu path.

Uwagi

Ta metoda nie sprawdza, czy ścieżka lub plik istnieje.

W przeciwieństwie do przeciążenia ciągu ta metoda nie normalizuje separatorów katalogów.

Wartość A ReadOnlySpan<System.Char> jest "skutecznie pusta", jeśli:

• W systemie Windows wywołanie ReadOnlySpan<T>.IsEmpty tego zakresu znaków zwraca truewartość lub wszystkie jego znaki to spacje (' ').
• W systemie Unix wywołanie ReadOnlySpan<T>.IsEmpty tego zakresu znaków zwraca wartość true.

Możliwe wzorce zakresu znaków tylko do odczytu zwrócone przez tę metodę są następujące:

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

• ReadOnlySpan<T>.Empty (path określono ścieżkę względną na bieżącym dysku lub woluminie).

• "/" (Unix: path określono ścieżkę bezwzględną na bieżącym dysku).

• "X:" (Windows: path określono ścieżkę względną na dysku, gdzie X reprezentuje dysk lub literę woluminu).

• "X:\" (Windows: path określono ścieżkę bezwzględną na danym dysku).

• "\\ComputerName\SharedFolder" (Windows: ścieżka UNC).

• "\\?\C:" (Windows: ścieżka urządzenia DOS obsługiwana w wersjach .NET Core 1.1 i nowszych oraz w .NET Framework 4.6.2 i nowszych wersjach).

Aby uzyskać więcej informacji na temat ścieżek plików w systemie Windows, zobacz Formaty ścieżek plików w systemach Windows. Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• Formaty ścieżek plików w systemie Windows