语言

Path.GetFileName 方法

定义

重载

名称 说明
GetFileName(ReadOnlySpan<Char>)

返回由只读字符范围表示的文件路径的文件名和扩展名。

GetFileName(String)

返回指定路径字符串的文件名和扩展名。

GetFileName(ReadOnlySpan<Char>)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
Source:
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目录的末尾(如后面返回)GetPathRoot的字符path。 如果 path 以目录分隔符结尾或只包含根,则该方法返回 ReadOnlySpan<T>.Empty。 如果 path 不包含目录分隔符和根,该方法将 path返回 。

在Windows上,根可以是驱动器或 UNC 共享。 有关其他根格式(如 DOS 设备路径),请参阅Windows系统上的文件格式。 在 C:file.txt中,根是 C:,因此文件名为 file.txt。 UNC 根(例如 \\server\share 包含目录分隔符),但它们是根的一部分,不会标记文件名的开头。 因此,文件名为 />,文件名为 空,因为整个路径是根路径。

另请参阅

适用于

GetFileName(String)

Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
Source:
Path.cs
Source:
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字符,以以后为准,或者null如果是pathnull。

例外

低于 2.1 的 .NET Framework 和 .NET Core 版本: path 包含在其中 GetInvalidPathChars()定义的一个或多个无效字符。

示例

以下示例演示基于Windows桌面平台上的 GetFileName 方法的行为。

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根path的末尾(如后面返回的GetPathRoot)的字符path。 如果 path 以目录分隔符结尾或只包含根,则该方法返回 String.Empty。 如果 path 不包含目录分隔符和根,该方法将 path返回 。

在Windows上,根可以是驱动器或 UNC 共享。 有关其他根格式(如 DOS 设备路径),请参阅Windows系统上的文件格式。 在 C:file.txt中,根是 C:,因此文件名为 file.txt。 UNC 根(例如 \\server\share 包含目录分隔符),但它们是根的一部分,不会标记文件名的开头。 因此,文件名为 />,文件名为 空,因为整个路径是根路径。

由于 是 Unix 上的合法文件名,因此在基于 Unix 的平台下运行的 无法从基于 Windows 的路径(如 C:\mydir\myfile.ext 但在基于Windows的平台下运行的 可以从基于 Unix 的路径(如 /tmp/myfile.ext 因此, 方法的行为在基于 Unix 和基于 Windows 的平台上并不严格相同。

有关常见 I/O 任务的列表,请参阅 常见 I/O 任务。

另请参阅

适用于