Path.GetPathRoot Metoda
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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ů. |
- 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ítrue
nebo 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
Platí pro
- 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:
- Volání v tomto rozsahu znaků ve Windows ReadOnlySpan<T>.IsEmpty vrátí
true
hodnotu nebo všechny jeho znaky jsou mezery (' '). - Volání v systému Unix v ReadOnlySpan<T>.IsEmpty tomto rozsahu znaků vrátí
true
hodnotu .
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
Zpětná vazba k produktu .NET
.NET je open source projekt. Vyberte odkaz pro poskytnutí zpětné vazby: