Path.GetPathRoot Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestawy:

netstandard.dll, System.Runtime.dll

Przeciążenia

Nazwa	Opis
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 folderu path , jeśli jest zakorzeniony.

— lub —

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

— lub —

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

Wyjątki

ArgumentException

Wersje .NET Framework i .NET Core starsze niż 2.1: path zawierają co najmniej jeden nieprawidłowy znak zdefiniowany w programie GetInvalidPathChars().

— lub —

Tylko program .NET Framework: 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:\'

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 wartość truelub wszystkie jego znaki to spacje (' ').
• W systemie Unix wywołanie IsNullOrEmpty tego ciągu zwraca wartość true.

Możliwe wzorce dla ciągu zwróconego 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 platformy .NET i w programie .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 systemach Windows
• Wejście/Wyjście plików i strumieni
• 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 .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ływanie 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 platformy .NET i w programie .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 systemach Windows