Path.GetFileName 方法

定义

命名空间:
System.IO
程序集:
netstandard.dll
程序集:
mscorlib.dll, System.Runtime.Extensions.dll
程序集:
mscorlib.dll
程序集:
System.Runtime.Extensions.dll

重载

名称 说明
GetFileName(ReadOnlySpan<Char>)

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

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

GetFileName(ReadOnlySpan<Char>)

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

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。

另请参阅

适用于

GetFileName(String)

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

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

低于 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。

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

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

另请参阅

适用于