Path.GetExtension メソッド

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

C#

public static string GetExtension
 (
    string path
)

C++

public:
static String^ GetExtension (
    String^ path
)

J#

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

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

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

J#

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

プラットフォーム

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 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む