Path.GetDirectoryName Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Aşırı Yüklemeler

Name	Description
GetDirectoryName(String)	Belirtilen yol için dizin bilgilerini döndürür.
GetDirectoryName(ReadOnlySpan<Char>)	Bir karakter aralığıyla temsil edilen belirtilen yol için dizin bilgilerini döndürür.

GetDirectoryName(String)

Kaynak:

Path.cs

Belirtilen yol için dizin bilgilerini döndürür.

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

Parametreler

path

String

Bir dosya veya dizinin yolu.

Döndürülenler

String

için pathdizin bilgileri veya null bir kök dizini belirtirse path veya null ise. Dizin bilgileri içermiyorsa path döndürürEmpty.

Özel durumlar

ArgumentException

2.1'den eski .NET Framework ve .NET Core sürümleri: path parametresi geçersiz karakterler içeriyor, boş veya yalnızca boşluk içeriyor.

PathTooLongException

path parametresi, sistem tarafından tanımlanan maksimum uzunluktan daha uzundur.

Örnekler

Aşağıdaki örnek, Windows tabanlı bir masaüstü platformunda GetDirectoryName yönteminin kullanılmasını gösterir.

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

Açıklamalar

Çoğu durumda, bu yöntem tarafından döndürülen dize, en son dizin ayırıcı karakterlerini dahil etmeyen en çok yoldaki tüm karakterlerden oluşur. Dizin ayırıcı karakteri veya DirectorySeparatorCharAltDirectorySeparatorCharolabilir. Yol "c:\" gibi bir kök dizinden oluşuyorsa döndürülür null .

Bu yöntem "file:" kullanan yolları desteklemez.

Döndürülen yol son dizin ayırıcı karakterlerini içermediğinden, döndürülen yolu yönteme GetDirectoryName geri geçirerek sonuç yolundaki sonraki çağrı başına bir klasör düzeyi kesilir. Örneğin, "C:\Directory\SubDirectory\test.txt" yolunun geçirilmesi GetDirectoryName "C:\Directory\SubDirectory" döndürür. "C:\Directory\SubDirectory" yolunu içine geçirerek GetDirectoryName "C:\Directory" döndürür.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç görevleri.

Ayrıca bkz.

• Windows sistemlerinde Dosya yolu biçimleri
• Dosya ve Akış G/Ç'si
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Dosyaya Metin Yazma

GetDirectoryName(ReadOnlySpan<Char>)

Kaynak:

Path.cs

Bir karakter aralığıyla temsil edilen belirtilen yol için dizin bilgilerini döndürür.

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)

Parametreler

path

ReadOnlySpan<Char>

Dizin bilgilerini almak için yol.

Döndürülenler

ReadOnlySpan<Char>

için dizin bilgileri pathveya boş bir yayılma alanı, pathnullboş bir yayılma alanı veya kök (\, C: veya \\server\share gibi).

Açıklamalar

Dize aşırı yüklemesinin aksine, bu yöntem dizin ayırıcılarını normalleştirmez.

Ayrıca bkz.

• Windows sistemlerinde Dosya yolu biçimleri