Path.GetPathRoot Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
GetPathRoot(String)	Získá informace o kořenovém adresáři z cesty obsažené v zadaném řetězci.
GetPathRoot(ReadOnlySpan<Char>)	Získá informace o kořenovém adresáři z cesty obsažené v zadaném rozsahu znaků.

GetPathRoot(String)

Zdroj:

Path.Unix.cs

Získá informace o kořenovém adresáři z cesty obsažené v zadaném řetězci.

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

Řetězec obsahující cestu, ze které chcete získat informace o kořenovém adresáři.

Návraty

String

Kořenový adresář path v případě, že je kořenový.

nebo

Empty pokud path neobsahuje informace o kořenovém adresáři.

nebo

null pokud path je null nebo je v podstatě prázdný.

Výjimky

ArgumentException

Verze .NET Framework a .NET Core starší než 2.1: path obsahuje jeden nebo více neplatných znaků definovaných v GetInvalidPathChars().

nebo

Pouze rozhraní .NET Framework: Empty bylo předáno .path

Příklady

Následující příklad ukazuje použití 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:\'

Poznámky

Tato metoda neověřuje, že cesta nebo soubor existují.

Tato metoda normalizuje oddělovače adresářů.

Řetězec je "efektivně prázdný", pokud:

• Ve Windows volání IsEmpty tohoto řetězce vrátí truenebo všechny jeho znaky jsou mezery (' ').
• V unixu volání IsNullOrEmpty na tento řetězec vrátí true.

Možné vzory pro řetězec vrácený touto metodou jsou následující:

• null (path byl null nebo prázdný řetězec).

• Prázdný řetězec (path zadal relativní cestu na aktuální jednotce nebo svazku).

• "/" (Unix: path zadal absolutní cestu na aktuální jednotce).

• "X:" (Windows: path zadal relativní cestu na jednotce, kde X představuje jednotku nebo písmeno svazku).

• "X:\" (Windows: path zadal absolutní cestu na dané jednotce).

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

• "\?\C:" (Windows: cesta zařízení DOS podporovaná ve verzích .NET a v rozhraní .NET Framework 4.6.2 a novějších verzích).

Další informace o cestách k souborům ve Windows naleznete v tématu Formáty cest k souborům v systémech Windows. Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

• Formáty cest k souborům v systémech Windows
• Vstup/výstup souborů a streamů
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

GetPathRoot(ReadOnlySpan<Char>)

Zdroj:

Path.Unix.cs

Získá informace o kořenovém adresáři z cesty obsažené v zadaném rozsahu znaků.

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>

Rozsah znaků obsahujících cestu, ze které chcete získat informace o kořenovém adresáři, je jen pro čtení.

Návraty

ReadOnlySpan<Char>

Rozsah znaků obsahující kořenový adresář souboru path.

Poznámky

Tato metoda neověřuje, že cesta nebo soubor existují.

Na rozdíl od přetížení řetězce tato metoda nenormalizuje oddělovače adresářů.

A ReadOnlySpan<System.Char> je "efektivně prázdné", pokud:

• Ve Windows volání ReadOnlySpan<T>.IsEmpty na toto rozpětí znaků vrátí truenebo všechny jeho znaky jsou mezery (' ').
• V unixu volání ReadOnlySpan<T>.IsEmpty na toto rozpětí znaků vrátí true.

Možné vzory rozsahu znaků jen pro čtení vrácené touto metodou jsou následující:

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

• ReadOnlySpan<T>.Empty (path byla zadána relativní cesta na aktuální jednotce nebo svazku).

• "/" (Unix: path zadal absolutní cestu na aktuální jednotce).

• "X:" (Windows: path zadal relativní cestu na jednotce, kde X představuje jednotku nebo písmeno svazku).

• "X:\" (Windows: path zadal absolutní cestu na dané jednotce).

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

• "\?\C:" (Windows: cesta zařízení DOS podporovaná ve verzích .NET a v rozhraní .NET Framework 4.6.2 a novějších verzích).

Další informace o cestách k souborům ve Windows naleznete v tématu Formáty cest k souborům v systémech Windows. Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

• Formáty cest k souborům v systémech Windows