Path.GetFileName Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

Перегрузки

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

GetFileName(ReadOnlySpan<Char>)

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

Path.cs

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

public:
 static ReadOnlySpan<char> GetFileName(ReadOnlySpan<char> path);

public static ReadOnlySpan<char> GetFileName (ReadOnlySpan<char> path);

static member GetFileName : ReadOnlySpan<char> -> ReadOnlySpan<char>

Public Shared Function GetFileName (path As ReadOnlySpan(Of Char)) As ReadOnlySpan(Of Char)

Параметры

path

ReadOnlySpan<Char>

Диапазон только для чтения, содержащий путь, из которого нужно получить имя и расширение файла.

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

ReadOnlySpan<Char>

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

Комментарии

Возвращаемый диапазон только для чтения содержит символы пути, следующие за последним разделителем в path. Если последний символ в path является разделителем тома или каталога, метод возвращает ReadOnlySpan<T>.Empty. Если path не содержит символа-разделителя, метод возвращает path.

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

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

GetFileName(String)

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

Path.cs

Возвращает имя файла и расширение указанной строки пути.

public:
 static System::String ^ GetFileName(System::String ^ path);

public static string? GetFileName (string? path);

static member GetFileName : string -> string

Public Shared Function GetFileName (path As String) As String

Параметры

path

String

Строка пути, из которой нужно получить имя файла и расширение.

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

String

Символы, следующие за последним символом разделителя каталогов в пути path. Если последним символом параметра path является символ разделения тома или каталога, этот метод возвращает Empty. Если значением параметра path является null, метод возвращает null.

Исключения

ArgumentException

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

Примеры

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

String^ fileName = "C:\\mydir\\myfile.ext";
String^ path = "C:\\mydir\\";
String^ result;
result = Path::GetFileName( fileName );
Console::WriteLine( "GetFileName('{0}') returns '{1}'", fileName, result );
result = Path::GetFileName( path );
Console::WriteLine( "GetFileName('{0}') returns '{1}'", path, result );

// This code produces output similar to the following:
//
// GetFileName('C:\mydir\myfile.ext') returns 'myfile.ext'
// GetFileName('C:\mydir\') returns ''

string fileName = @"C:\mydir\myfile.ext";
string path = @"C:\mydir\";
string result;

result = Path.GetFileName(fileName);
Console.WriteLine("GetFileName('{0}') returns '{1}'",
    fileName, result);

result = Path.GetFileName(path);
Console.WriteLine("GetFileName('{0}') returns '{1}'",
    path, result);

// This code produces output similar to the following:
//
// GetFileName('C:\mydir\myfile.ext') returns 'myfile.ext'
// GetFileName('C:\mydir\') returns ''

Dim fileName As String = "C:\mydir\myfile.ext"
Dim pathname As String = "C:\mydir\"
Dim result As String

result = Path.GetFileName(fileName)
Console.WriteLine("GetFileName('{0}') returns '{1}'", fileName, result)

result = Path.GetFileName(pathname)
Console.WriteLine("GetFileName('{0}') returns '{1}'", pathname, result)

' This code produces output similar to the following:
'
' GetFileName('C:\mydir\myfile.ext') returns 'myfile.ext'
' GetFileName('C:\mydir\') returns ''

Комментарии

Возвращаемое значение равно , null если путь к файлу — null.

Символы разделителя, используемые для определения начала имени файла: DirectorySeparatorChar и AltDirectorySeparatorChar.

Так как \ является законным именем файла в Unix, GetFileName выполнение на платформах под управлением Unix не может правильно возвращать имя файла из пути на основе Windows, например C:\mydir\myfile.ext, но GetFileName выполнение на платформах под управлением Windows может правильно возвращать имя файла из пути на основе Unix, например /tmp/myfile.ext, поэтому поведение GetFileName метода не является строго одинаковым на платформах под управлением Unix и Windows.

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

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

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