Path.GetFileName メソッド

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

C#

public static string GetFileName
 (
    string path
)

C++

public:
static String^ GetFileName (
    String^ path
)

J#

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

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

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

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Path クラス
Path メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む