Path.GetDirectoryName Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Перегрузки

GetDirectoryName(String)	Возвращает сведения о каталоге для указанного пути.
GetDirectoryName(ReadOnlySpan<Char>)	Возвращает сведения о каталоге для указанного пути, представленного диапазоном символов.

GetDirectoryName(String)

Исходный код:

Path.cs

Возвращает сведения о каталоге для указанного пути.

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

Параметры

path

String

Путь к файлу или каталогу.

Возвращаемое значение

String

Сведения о каталоге для path, или значение null, если путь path указывает на корневой каталог или равен NULL. Возвращает Empty, если параметр path не содержит сведения о каталоге.

Исключения

ArgumentException

платформа .NET Framework и .NET Core версий старше 2.1: path параметр содержит недопустимые символы, является пустым или содержит только пробелы.

PathTooLongException

Имя параметра path превышает максимально допустимую в системе длину.

Примечание. Вместо этого в .NET для приложений Магазина Windows или переносимой библиотеке классов перехватите исключение IOExceptionбазового класса , .

Примеры

В следующем примере показано использование GetDirectoryName метода на классической платформе Windows.

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

Комментарии

В большинстве случаев строка, возвращаемая этим методом, состоит из всех символов в пути до последних символов разделителя каталогов, но не включает их. Разделитель каталога может иметь значение DirectorySeparatorChar или AltDirectorySeparatorChar. Если путь состоит из корневого каталога, например "c:\", null возвращается.

Этот метод не поддерживает пути с использованием "file:".

Так как возвращаемый путь не содержит последние символы разделителя каталогов, передача возвращаемого пути обратно в GetDirectoryName метод усекает один уровень папки при каждом последующем вызове результируемого пути. Например, передача пути "C:\Directory\SubDirectory\test.txt" в возвращает GetDirectoryName "C:\Directory\SubDirectory". Передача этого пути "C:\Directory\SubDirectory" в возвращает GetDirectoryName "C:\Directory".

Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

См. также раздел

• Форматы путей к файлам в системах Windows
• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

GetDirectoryName(ReadOnlySpan<Char>)

Исходный код:

Path.cs

Возвращает сведения о каталоге для указанного пути, представленного диапазоном символов.

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)

Параметры

path

ReadOnlySpan<Char>

Путь для получения сведений о каталоге.

Возвращаемое значение

ReadOnlySpan<Char>

Сведения о каталоге для pathили пустой диапазон, если path имеет значение null, пустой диапазон или корень (например, \, C:или \\server\share).

Комментарии

В отличие от строковой перегрузки, этот метод не нормализует разделители каталогов.

См. также раздел

• Форматы путей к файлам в системах Windows