Path.GetDirectoryName Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
GetDirectoryName(String)	Vrátí informace o adresáři pro zadanou cestu.
GetDirectoryName(ReadOnlySpan<Char>)	Vrátí informace o adresáři pro zadanou cestu reprezentovanou znakovým rozsahem.

GetDirectoryName(String)

Zdroj:

Path.cs

Vrátí informace o adresáři pro zadanou cestu.

public:
 static System::String ^ GetDirectoryName(System::String ^ path);

public static string? GetDirectoryName(string? path);

static member GetDirectoryName : string -> string

Public Shared Function GetDirectoryName (path As String) As String

Parametry

path

String

Cesta k souboru nebo adresáři.

Návraty

String

Informace o adresáři pro path, nebo null pokud path označuje kořenový adresář nebo má hodnotu null. Vrátí Empty , pokud path neobsahuje informace o adresáři.

Výjimky

ArgumentException

.NET Framework a verze .NET Core starší než 2.1: Parametr path obsahuje neplatné znaky, je prázdný nebo obsahuje pouze prázdné znaky.

PathTooLongException

Parametr path je delší než maximální délka definovaná systémem.

Příklady

Následující příklad ukazuje použití metody GetDirectoryName na Windows desktopové platformě.

string? filePath = @"C:\MyDir\MySubDir\myfile.ext";
string? directoryName;
int i = 0;

while (filePath != null)
{
    directoryName = Path.GetDirectoryName(filePath);
    Console.WriteLine($"GetDirectoryName(\"{filePath}\") returns {directoryName ?? "NULL"}");

    filePath = (i == 1)
        ? directoryName + @"\"  // this will preserve the previous path
        : directoryName;

    i++;
}
/*
This code produces the following output:

GetDirectoryName("C:\MyDir\MySubDir\myfile.ext") returns C:\MyDir\MySubDir
GetDirectoryName("C:\MyDir\MySubDir") returns C:\MyDir
GetDirectoryName("C:\MyDir\") returns C:\MyDir
GetDirectoryName("C:\MyDir") returns C:\
GetDirectoryName("C:\") returns NULL
*/

Dim filepath As String = "C:\MyDir\MySubDir\myfile.ext"
Dim directoryName As String
Dim i As Integer = 0

While filepath <> Nothing
    directoryName = Path.GetDirectoryName(filepath)
    Console.WriteLine("GetDirectoryName('{0}') returns '{1}'", _
        filepath, directoryName)
    filepath = directoryName
    If i = 1 Then
       filepath = directoryName + "\"  ' this will preserve the previous path
    End If
    i = i + 1
End While

'This code produces the following output:
'
' GetDirectoryName('C:\MyDir\MySubDir\myfile.ext') returns 'C:\MyDir\MySubDir'
' GetDirectoryName('C:\MyDir\MySubDir') returns 'C:\MyDir'
' GetDirectoryName('C:\MyDir\') returns 'C:\MyDir'
' GetDirectoryName('C:\MyDir') returns 'C:\'
' GetDirectoryName('C:\') returns ''

Poznámky

Ve většině případů se řetězec vrácený touto metodou skládá ze všech znaků v cestě nahoru, ale ne zahrnutí, poslední znak oddělovače adresářů. Znak oddělovače adresáře může být buď DirectorySeparatorChar nebo AltDirectorySeparatorChar. Pokud se cesta skládá z kořenového adresáře, například "c:\", null je vrácena.

Tato metoda nepodporuje cesty pomocí "file:".

Vzhledem k tomu, že vrácená cesta neobsahuje poslední znak oddělovače adresářů, předání vrácené cesty zpět do GetDirectoryName metody zkrátí jednu úroveň složky na následné volání cesty výsledku. Například předání cesty "C:\Directory\SubDirectory\test.txt" do GetDirectoryName vrátí "C:\Directory\SubDirectory". Předáním této cesty C:\Directory\SubDirectory se GetDirectoryName vrátí "C:\Directory".

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

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

GetDirectoryName(ReadOnlySpan<Char>)

Zdroj:

Path.cs

Vrátí informace o adresáři pro zadanou cestu reprezentovanou znakovým rozsahem.

public:
 static ReadOnlySpan<char> GetDirectoryName(ReadOnlySpan<char> path);

public static ReadOnlySpan<char> GetDirectoryName(ReadOnlySpan<char> path);

static member GetDirectoryName : ReadOnlySpan<char> -> ReadOnlySpan<char>

Public Shared Function GetDirectoryName (path As ReadOnlySpan(Of Char)) As ReadOnlySpan(Of Char)

Parametry

path

ReadOnlySpan<Char>

Cesta k načtení informací o adresáři.

Návraty

ReadOnlySpan<Char>

Informace o adresáři nebo pathprázdné rozpětí, pokud path je null, prázdné rozpětí nebo kořen (například \, C:, nebo \\server\sdílená složka).

Poznámky

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

Viz také

• formáty cest Soubory v systémech Windows