Path.GetPathRoot Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Přetížení

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 pokud je root.

-nebo-

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

-nebo-

null pokud path je null nebo je skutečně prázdný.

Výjimky

ArgumentException

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

-nebo-

Pouze rozhraní .NET Framework: Empty bylo předáno do 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:\'

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, zda cesta nebo soubor existuje.

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

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

• Volání pro tento řetězec ve Windows IsEmpty vrátí truenebo všechny jeho znaky jsou mezery (' ').
• V unixu vrátí volání IsNullOrEmpty pro tento řetězec hodnotu true.

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

• null (path měl hodnotu null nebo prázdný řetězec).

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

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

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

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

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

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

Další informace o cestách k souborům ve Windows najdete 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 cesty k souborům v systémech Windows
• Vstupně-výstupní operace 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ů jen pro čtení obsahující cestu, ze které se mají získat informace o kořenovém adresáři.

Návraty

ReadOnlySpan<Char>

Rozsah znaků jen pro čtení obsahující kořenový adresář .path

Poznámky

Tato metoda neověřuje, zda cesta nebo soubor existuje.

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

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

• Volání v tomto rozsahu znaků ve Windows ReadOnlySpan<T>.IsEmpty vrátí truehodnotu nebo všechny jeho znaky jsou mezery (' ').
• Volání v systému Unix v ReadOnlySpan<T>.IsEmpty tomto rozsahu znaků vrátí truehodnotu .

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

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

• ReadOnlySpan<T>.Empty (path zadala relativní cestu na aktuální jednotce nebo svazku).

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

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

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

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

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

Další informace o cestách k souborům ve Windows najdete 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 cesty k souborům v systémech Windows