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

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

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

Das folgende Beispiel veranschaulicht die Verwendung der GetDirectoryName Methode für eine Windows-basierte desktop-Plattform.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, die von dieser Methode zurückgegebene Zeichenfolge enthält alle Zeichen im Pfad bis, jedoch nicht einschließlich dem letzten DirectorySeparatorChar oder AltDirectorySeparatorChar.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 des ein Stammverzeichnis, z. B. besteht aus "c:\", wird Null zurückgegeben.If the path consists of a root directory, such as "c:\", null is returned. Beachten Sie, dass es sich bei dieser Methode mithilfe von Pfaden nicht unterstützt "Datei:".Note that this method does not support paths using "file:". Da keine der zurückgegebene Pfad enthält die DirectorySeparatorChar oder AltDirectorySeparatorChar, übergeben die zurückgegebenen Pfad zurück in die GetDirectoryName Methode führt dazu, in das Abschneiden von eine Ordnerebene pro nachfolgenden Aufruf der Ergebniszeichenfolge.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. Beispielsweise der Pfad "C:\Directory\SubDirectory\test.txt" übergeben, in der GetDirectoryName "C:\Directory\SubDirectory"-Methode zurück.For example, passing the path "C:\Directory\SubDirectory\test.txt" into the GetDirectoryName method will return "C:\Directory\SubDirectory". Übergeben an dieser Begriff "C:\Directory\SubDirectory" GetDirectoryName führt zu "C:\Directory".Passing that string, "C:\Directory\SubDirectory", into GetDirectoryName will result in "C:\Directory".

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

Siehe auch

Gilt für: