Path.GetDirectoryName Path.GetDirectoryName Path.GetDirectoryName Path.GetDirectoryName Method

Definition

Überlädt

GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>)

Gibt die Verzeichnisinformationen für den angegebenen Pfad in Form einer Zeichenspanne zurück.Returns the directory information for the specified path represented by a character span.

GetDirectoryName(String) GetDirectoryName(String) GetDirectoryName(String) GetDirectoryName(String)

Gibt die Verzeichnisinformationen für die angegebene Pfadzeichenfolge zurück.Returns the directory information for the specified path string.

GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>) GetDirectoryName(ReadOnlySpan<Char>)

Gibt die Verzeichnisinformationen für den angegebenen Pfad in Form einer Zeichenspanne zurück.Returns the directory information for the specified path represented by a character span.

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, aus dem die Verzeichnisinformationen abgerufen werden sollen.The path to retrieve the directory information from.

Gibt zurück

Verzeichnisinformationen für path oder eine leere Spanne, wenn path null ist, eine leere Spanne oder ein Stamm (wie , C: oder \server\share).Directory information for path, or an empty span if path is null, an empty span, or a root (such as , C:, or \server\share).

Hinweise

Anders als bei der Zeichen folgen Überladung normalisiert diese Methode keine Verzeichnis Trennzeichen.Unlike the string overload, this method doesn't normalize directory separators.

Siehe auch

GetDirectoryName(String) GetDirectoryName(String) GetDirectoryName(String) GetDirectoryName(String)

Gibt die Verzeichnisinformationen für die angegebene Pfadzeichenfolge zurück.Returns the directory information for the specified path string.

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

Parameter

path
String String String String

Der Pfad einer Datei oder eines Verzeichnisses.The path of a file or directory.

Gibt zurück

Verzeichnisinformationen für path oder null, wenn path ein Stammverzeichnis bezeichnet oder NULL ist.Directory information for path, or null if path denotes a root directory or is null. Gibt Empty zurück, wenn path keine Verzeichnisinformationen enthält.Returns Empty if path does not contain directory information.

Ausnahmen

Der path-Parameter enthält nur ungültige Zeichen, ist leer oder enthält nur Leerzeichen.The path parameter contains invalid characters, is empty, or contains only white spaces.

Fangen Sie in .NET für Windows Store-Apps oder der portablen Klassenbibliothek stattdessen die Basisklassenausnahme IOException ab.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

Der path-Parameter überschreitet die vom System definierte Maximallänge.The path parameter is longer than the system-defined maximum length.

Beispiele

Im folgenden Beispiel wird die Verwendung GetDirectoryName der-Methode auf einer Windows-basierten Desktop Plattform veranschaulicht.The following example demonstrates using the GetDirectoryName method on a Windows-based desktop platform.

String^ filePath = "C:\\MyDir\\MySubDir\\myfile.ext";
String^ directoryName;
int i = 0;

while (filePath != nullptr)
{
    directoryName = Path::GetDirectoryName(filePath);
    Console::WriteLine("GetDirectoryName('{0}') returns '{1}'",
        filePath, directoryName);
    filePath = directoryName;
    if (i == 1)
    {
        filePath = directoryName + "\\";  // this will preserve the previous path
    }
    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 ''
*/
string filePath = @"C:\MyDir\MySubDir\myfile.ext";
string directoryName;
int i = 0;

while (filePath != null)
{
    directoryName = Path.GetDirectoryName(filePath);
    Console.WriteLine("GetDirectoryName('{0}') returns '{1}'",
        filePath, directoryName);
    filePath = directoryName;
    if (i == 1)
    {
        filePath = directoryName + @"\";  // this will preserve the previous path
    }
    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 ''
*/
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
       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 Zeichenfolge, die von dieser Methode zurückgegeben wird, aus allen Zeichen im Pfad bis einschließlich DirectorySeparatorChar des AltDirectorySeparatorCharletzten oder.In most cases, the string returned by this method consists of all characters in the path up to but not including the last DirectorySeparatorChar or AltDirectorySeparatorChar. Wenn der Pfad aus einem Stammverzeichnis (z. b. "c\:") besteht, wird NULL zurückgegeben.If the path consists of a root directory, such as "c:\", null is returned. Beachten Sie, dass diese Methode keine Pfade unterstützt, die "file:" verwenden.Note that this method does not support paths using "file:". Da der zurückgegebene Pfad nicht das DirectorySeparatorChar oder AltDirectorySeparatorCharenthält, führt die Übergabe des zurückgegebenen Pfads zurück an die GetDirectoryName -Methode dazu, dass eine Ordnerebene pro nachfolgenden Aufrufe der Ergebnis Zeichenfolge abgeschnitten wird.Because the returned path does not include the DirectorySeparatorChar or AltDirectorySeparatorChar, passing the returned path back into the GetDirectoryName method will result in the truncation of one folder level per subsequent call on the result string. Wenn Sie z. b. den Pfad "c:\Directory\SubDirectory\test.txt" GetDirectoryName an die Methode übergeben, wird "c:\Directory\SubDirectory" zurückgegeben.For example, passing the path "C:\Directory\SubDirectory\test.txt" into the GetDirectoryName method will return "C:\Directory\SubDirectory". Wenn Sie die Zeichenfolge "c:\direct\subdirectory" in GetDirectoryName übergeben, wird "c:\directory" angezeigt.Passing that string, "C:\Directory\SubDirectory", into GetDirectoryName will result in "C:\Directory".

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Gilt für: