Path.GetFileName Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| GetFileName(ReadOnlySpan<Char>) |
Возвращает имя файла и расширение пути к файлу, представленного диапазоном символов только для чтения. |
| GetFileName(String) |
Возвращает имя файла и расширение указанной строки пути. |
GetFileName(ReadOnlySpan<Char>)
- Исходный код:
- Path.cs
- Исходный код:
- Path.cs
- Исходный код:
- Path.cs
- Исходный код:
- Path.cs
- Исходный код:
- 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>
Диапазон только для чтения, содержащий путь, из которого необходимо получить имя файла и расширение.
Возвращаемое значение
Символы после последнего символа разделителя каталогов в path.
Комментарии
Возвращаемый диапазон только для чтения содержит символы пути, который следует последнему разделителю.path Если последний символ является path символом разделителя томов или каталогов, метод возвращается ReadOnlySpan<T>.Empty. Если path нет символа разделителя, метод возвращается path.
См. также раздел
- форматы пути File в системах Windows
Применяется к
GetFileName(String)
- Исходный код:
- Path.cs
- Исходный код:
- Path.cs
- Исходный код:
- Path.cs
- Исходный код:
- Path.cs
- Исходный код:
- Path.cs
Возвращает имя файла и расширение указанной строки пути.
public:
static System::String ^ GetFileName(System::String ^ path);
public static string GetFileName(string path);
public static string? GetFileName(string? path);
static member GetFileName : string -> string
Public Shared Function GetFileName (path As String) As String
Параметры
- path
- String
Строка пути, из которой необходимо получить имя файла и расширение.
Возвращаемое значение
Символы после последнего символа разделителя каталогов в path. Если последний символ является символом каталога или разделителя томов path , этот метод возвращается Empty. В path противном случае nullэтот метод возвращается null.
Исключения
Версии .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 ''
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.
Символы разделителя, используемые для определения начала имени файла, и DirectorySeparatorCharAltDirectorySeparatorChar.
Так как \ является юридическим именем файла в Unix, GetFileName, выполняющейся на платформах Unix, не может правильно возвращать имя файла из пути на основе Windows, например C:\mydir\myfile.ext, но GetFileName, запущенные на Windows платформах, могут правильно возвращать имя файла из пути на основе Unix, например /tmp/myfile.ext поэтому поведение метода GetFileName не является строго одинаковым на платформах на основе Unix и Windows.
Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.
См. также раздел
- форматы пути File в системах Windows
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл