Path.GetFileName メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Path.GetFileName メソッド

指定したパス文字列のファイル名と拡張子を返します。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetFileName
 ( _
    path As String _
) As String

Visual Basic (使用法)

Dim path As String
Dim returnValue As String

returnValue = Path.GetFileName(path)

public static string GetFileName
 (
    string path
)

C++

public:
static String^ GetFileName (
    String^ path
)

public static String GetFileName (
    String path
)

JScript

public static function GetFileName
 (
    path : String
) : String

パラメータ

path: ファイル名と拡張子の取得元のパス文字列。

戻り値
path の最後のディレクトリ文字の後ろの文字で構成される String。path の最後の文字がディレクトリ区切り記号またはボリューム区切り記号の場合、このメソッドは Empty を返します。path が null 参照 (Visual Basic では Nothing) の場合、このメソッドは null 参照 (Visual Basic では Nothing) を返します。

例外

例外の種類	条件
ArgumentException	path に、InvalidPathChars で定義されている無効な文字が 1 つ以上含まれているか、ワイルドカード文字が含まれています。

解説

ファイルパスが null 参照 (Visual Basic では Nothing) の場合、戻り値は null 参照 (Visual Basic では Nothing) です。

ファイル名の先頭を決定するために使用する区切り記号は、DirectorySeparatorChar および AltDirectorySeparatorChar です。

このメソッドの使用例については、以下の「使用例」を参照してください。その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
ファイルの絶対パスを取得する。	GetFullPath
パスからファイル名だけを取得する。	GetFileNameWithoutExtension
パスからディレクトリ名だけを取得する。	GetDirectoryName
ファイルの拡張子を変更する。	ChangeExtension

使用例

Windows ベースのデスクトッププラットフォーム上で GetFileName メソッドを使用するコード例を次に示します。

Visual Basic

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 ''

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 ''

C++

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 );

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);

JScript

var fileName : String = "C:\\mydir\\myfile.ext";
var path : String = "C:\\mydir\\";
var result : String;

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

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