Freigeben über

Path.GetDirectoryName Methode

Definition

Namespace:
System.IO
Assemblys:
mscorlib.dll, System.Runtime.Extensions.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Überlädt

Name Beschreibung
GetDirectoryName(String)

Gibt die Verzeichnisinformationen für den angegebenen Pfad zurück.
GetDirectoryName(ReadOnlySpan<Char>)

Gibt die Verzeichnisinformationen für den angegebenen Pfad zurück, der durch einen Zeichenbereich dargestellt wird.

GetDirectoryName(String)

Quelle:
Path.cs
Quelle:
Path.cs
Quelle:
Path.cs
Quelle:
Path.cs
Quelle:
Path.cs

Gibt die Verzeichnisinformationen für den angegebenen Pfad zurück.

public:
 static System::String ^ GetDirectoryName(System::String ^ path);
public static string GetDirectoryName(string path);
public static string? GetDirectoryName(string? path);
static member GetDirectoryName : string -> string
Public Shared Function GetDirectoryName (path As String) As String

Parameter

path
String

Der Pfad einer Datei oder eines Verzeichnisses.

Gibt zurück

String

Verzeichnisinformationen für pathoder wenn path ein Stammverzeichnis angegeben wird oder null null ist. Gibt zurück Empty , wenn path keine Verzeichnisinformationen enthalten.

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: Der Parameter path enthält ungültige Zeichen, ist leer oder enthält nur Leerzeichen.

PathTooLongException

Der path Parameter ist länger als die vom System definierte maximale Länge.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der GetDirectoryName-Methode auf einer Windows-basierten Desktopplattform.

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 ''

Hinweise

In den meisten Fällen besteht die von dieser Methode zurückgegebene Zeichenfolge aus allen Zeichen im Pfad bis zu den letzten Verzeichnistrennzeichen. Ein Verzeichnistrennzeichen kann entweder DirectorySeparatorChar oder AltDirectorySeparatorChar. Wenn der Pfad aus einem Stammverzeichnis besteht, z. B. "c:\", null wird zurückgegeben.

Diese Methode unterstützt keine Pfade mit "file:".

Da der zurückgegebene Pfad nicht das letzte Verzeichnistrennzeichen enthält, schneidet das Übergeben des zurückgegebenen Pfads wieder in die GetDirectoryName Methode eine Ordnerebene pro nachfolgendem Aufruf des Ergebnispfads ab. Übergeben Sie beispielsweise den Pfad "C:\Directory\SubDirectory\test.txt" in GetDirectoryName "C:\Directory\SubDirectory". Durch Übergeben dieses Pfads "C:\Directory\SubDirectory" in "C:\Directory" wird GetDirectoryName "C:\Directory" zurückgegeben.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

GetDirectoryName(ReadOnlySpan<Char>)

Quelle:
Path.cs
Quelle:
Path.cs
Quelle:
Path.cs
Quelle:
Path.cs
Quelle:
Path.cs

Gibt die Verzeichnisinformationen für den angegebenen Pfad zurück, der durch einen Zeichenbereich dargestellt wird.

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)

Parameter

path
ReadOnlySpan<Char>

Der Pfad zum Abrufen der Verzeichnisinformationen.

Gibt zurück

ReadOnlySpan<Char>

Verzeichnisinformationen für pathoder eine leere Spanne, wenn es sich um path eine leere Spanne oder einen Stamm (z. B. \, C:oder \\server\freigabe) handelt null.

Hinweise

Im Gegensatz zur Zeichenfolgenüberladung normalisiert diese Methode keine Verzeichnistrennzeichen.

Weitere Informationen

Gilt für: