Path.GetExtension 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

GetExtension(ReadOnlySpan<Char>)	傳回檔案路徑的副檔名，此路徑以唯讀的字元範圍表示。
GetExtension(String)	指定路徑字串的副檔名 (包括句點 ".")。

GetExtension(ReadOnlySpan<Char>)

來源:

Path.cs

傳回檔案路徑的副檔名，此路徑以唯讀的字元範圍表示。

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

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

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

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

參數

path

ReadOnlySpan<Char>

可取得副檔名的檔案路徑。

傳回

ReadOnlySpan<Char>

指定路徑的副檔名 (包括句點 ".")，如果 path 沒有副檔名資訊，則為 Empty。

備註

這個方法會藉由搜尋 path 句點 (「，來取得 的 path 延伸。) ，從唯讀範圍的最後一個字元開始，並繼續進行其第一個字元。 如果在 或 AltDirectorySeparatorChar 字元之前 DirectorySeparatorChar 找到句點，則傳回的唯讀範圍會包含句點和之後的字元， ReadOnlySpan<T>.Empty 否則會傳回 。

另請參閱

• Windows 系統上的檔案路徑格式

GetExtension(String)

來源:

Path.cs

指定路徑字串的副檔名 (包括句點 ".")。

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

public static string? GetExtension (string? path);

static member GetExtension : string -> string

Public Shared Function GetExtension (path As String) As String

參數

path

String

要從中取得副檔名的路徑字串。

傳回

String

指定路徑的副檔名 (包括句點 ".")、null 或 Empty。 如果 path 是 null，則 GetExtension(String) 會傳回 null。 如果 path 沒有副檔名資訊，則 GetExtension(String) 會傳回 Empty。

例外狀況

ArgumentException

.NET Framework和 2.1 之前的 .NET Core 版本： path 包含 中 GetInvalidPathChars() 定義的一或多個無效字元。

範例

下列範例示範如何在以 Windows 為基礎的桌面平臺上使用 GetExtension 方法。

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

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

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

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

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

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

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

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

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

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

備註

這個方法會藉由搜尋 path 句點 (.) ，從 中的 path 最後一個字元開始，並繼續進行第一個字元，來取得 的 path 延伸。 如果在 或 AltDirectorySeparatorChar 字元之前 DirectorySeparatorChar 找到句點，則傳回的字串會包含句號和之後的字元， String.Empty 否則會傳回 。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• Windows 系統上的檔案路徑格式
• 檔案和資料流 I/O
• 作法：讀取檔案中的文字
• 作法：將文字寫入檔案