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

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

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

Path.GetExtension メソッド

指定したパス文字列の拡張子を返します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim path As String
Dim returnValue As String

returnValue = Path.GetExtension(path)

public static string GetExtension
 (
    string path
)

C++

public:
static String^ GetExtension (
    String^ path
)

public static String GetExtension (
    String path
)

JScript

public static function GetExtension
 (
    path : String
) : String

パラメータ

path: 拡張子の取得元のパス文字列。

戻り値
指定したパスの拡張子 ("." を含む)、null 参照 (Visual Basic では Nothing)、または Empty を含む String。path が null 参照 (Visual Basic では Nothing) の場合、GetExtension は null 参照 (Visual Basic では Nothing) を返します。path が拡張子情報を持たない場合、GetExtension は Empty を返します。

例外

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

解説

path の拡張子は、パスの最後の文字から、パスの先頭に向かって、path のピリオド (.) を検索して取得します。ピリオドが DirectorySeparatorChar 文字または AltDirectorySeparatorChar 文字の前で見つかった場合は、返される文字列にはピリオドとその後ろの文字が含まれます。それ以外の場合は、Empty が返されます。

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

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

使用例

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

Visual Basic

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

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

C++

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

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

JScript

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

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

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