Path.GetFileName 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| 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 包含目录分隔符),但它们是根的一部分,不会标记文件名的开头。 因此,文件名为
由于
有关常见 I/O 任务的列表,请参阅 常见 I/O 任务。