Path.GetPathRoot Metoda

Definice

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
Zdroj:
Path.Unix.cs
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);
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

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

.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é

Platí pro

GetPathRoot(ReadOnlySpan<Char>)

Zdroj:
Path.Unix.cs
Zdroj:
Path.Unix.cs
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

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:

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é

Platí pro