CodeGym /コース /C# SELF /クラス Path — パス操作の頼れる...

クラス Path — パス操作の頼れる相棒

C# SELF
レベル 39, レッスン 4
使用可能

1. はじめに

そもそもなぜPathが必要なの?

ファイル操作はパスなしでは成立しない。パスはプログラムに「どこにファイルやフォルダがあるか」を教えてくれるんだ。

日常生活なら住所があるよね:市、通り、番地。コンピュータでのファイルのパスはだいたいこんな感じ:
"C:\Program Files\MyApp\data.txt"
あるいはクロスプラットフォームを意識しているなら:
"/home/username/documents/data.txt"

問題は、OSごとに区切り文字が違ったり、長さや使える文字に制限があったりすること。ユーザーが手入力するとミスしがちだ:Windowsの二重バックスラッシュ(\\)とか、Unix系だとパスが / で始まるとか、知らないとハマるポイントがある。

無理に自前で作らなくても、.NET は静的クラス System.IO.Path を提供していて、パスの解析・変更・結合を任せられる。さあ、このヒーローを詳しく見ていこう!

Path が解決する主なタスク

  • ファイルの拡張子を取得する。
  • フルパスからファイル名やフォルダ名を取り出す。
  • パーツから絶対/相対パスを組み立てる。
  • そのOSで有効なパスかどうかをチェックする。
  • ファイルの拡張子を置き換える。
  • ベースディレクトリや親フォルダを特定する。
  • パス区切り文字のクロスプラットフォーム対応。
  • 一時ファイルや一時ディレクトリの扱い。

表:主なメソッドとプロパティ(Path)

メソッド/プロパティ 説明
GetFileName(path)
拡張子付きのファイル名
GetExtension(path)
ファイルの拡張子(例: .txt)
GetDirectoryName(path)
ファイルがあるフォルダへのパス
GetFileNameWithoutExtension(path)
拡張子なしのファイル名
Combine(...)
パスのパーツを正しくクロスプラットフォームで結合する
ChangeExtension(path, ext)
ファイルの拡張子を変更する
GetFullPath(path)
絶対パスを返す
GetInvalidPathChars()
パスで使えない文字
GetInvalidFileNameChars()
ファイル名で使えない文字
GetTempPath()
一時ファイル用フォルダのパス
GetTempFileName()
ユニークな一時ファイルを作ってそのパスを返す
DirectorySeparatorChar
ディレクトリ区切り文字(例: \ や /)
AltDirectorySeparatorChar
代替の区切り文字
PathSeparator
環境変数内のパス区切り文字(; や :)

2. パスの部分を取得する

ほとんどの Path のメソッドは static だよ。インスタンスを作る必要はない — そのまま Path.メソッド名(...) を呼べばOK。

よく使うのは GetFileName, GetDirectoryName, GetExtension, GetFileNameWithoutExtension。いつでもパスからファイル名だけ取り出したり、拡張子だけ知りたかったり、ファイルがどのフォルダにあるかを知りたくなる。

例:


using System;
using System.IO;

string path = @"C:\Projects\MyApp\data\info.json";

Console.WriteLine(Path.GetFileName(path));               // info.json
Console.WriteLine(Path.GetFileNameWithoutExtension(path)); // info
Console.WriteLine(Path.GetExtension(path));              // .json
Console.WriteLine(Path.GetDirectoryName(path));          // C:\Projects\MyApp\data
コード 結果
@"C:\Projects\MyApp\data\info.json"
info.json
Path.GetFileName(path)
Path.GetExtension(path)
.json
Path.GetFileNameWithoutExtension(path)
info
Path.GetDirectoryName(path)
C:\Projects\MyApp\data

3. パスの結合: Combine

初心者がやりがちなミスは文字列の単純な連結でパスを作ること。そうしないで!

悪い例:


// バグの温床になるよ!
string fullPath = "C:\\Projects\\MyApp\\" + "data\\info.json";

スラッシュやバックスラッシュを付け忘れたらどうする?区切り文字を間違えたら?
正しい方法は Path.Combine を使うこと。


string folder = @"C:\Projects\MyApp";
string filename = "data\\info.json";

string fullPath = Path.Combine(folder, filename);

// どのプラットフォームでも正しくパスを結合してくれる!
Console.WriteLine(fullPath); // C:\Projects\MyApp\data\info.json

相対パスの扱い

相対パスを渡しても、Path.Combine は正しく処理してくれる。パスはセグメントごとに分ける癖をつけよう!


string baseDir = "C:/work";
string subDir = "docs";
string file = "readme.txt";

string path = Path.Combine(baseDir, subDir, file);
// 結果: "C:/work/docs/readme.txt"(あるいはプラットフォームによってはバックスラッシュ)

ワンポイント: Path.Combine の内部では、そのOSに合った区切り文字が使われる。Windowsなら \、Linux/Macなら /。意識せずともコードがクロスプラットフォームになるよ!

4. パスの妥当性チェック

このためのメソッドがある:GetInvalidPathChars, GetInvalidFileNameChars。

例えば、ユーザーがUIからファイル名やパスを入力してきたとき、その文字列に使えない文字が含まれていないかどうか確かめたいよね。Path に聞けばいい。


char[] invalidPathChars = Path.GetInvalidPathChars();
char[] invalidFileNameChars = Path.GetInvalidFileNameChars();

string userInput = "data*?.txt";
foreach (char c in userInput)
{
    if (Array.Exists(invalidFileNameChars, x => x == c))
    {
        Console.WriteLine($"ファイル名に使えない文字: {c}");
    }
}
// 出力例: ファイル名に使えない文字: *

ユーザーや信頼できないソースからパスを受け取るときは、特に重要だよ!

5. 便利なメソッド

拡張子の変更: ChangeExtension

ファイルの拡張子を別のものに変えたいときがある。一行でできるよ!


string oldPath = @"C:\data\report.csv";
string newPath = Path.ChangeExtension(oldPath, ".bak");

Console.WriteLine(newPath); // C:\data\report.bak

ChangeExtension はパスの他の部分には触らず、末尾だけ置き換えるよ。

絶対パスを取得する: GetFullPath

相対パスなら、このメソッドで絶対(フル)パスを取得できる。


string relPath = @"..\..\logs\2024.log";
string absPath = Path.GetFullPath(relPath);

Console.WriteLine(absPath);
// 例えば: C:\Projects\MyApp\logs\2024.log

実際の結果はアプリの現在の作業ディレクトリ(Directory.GetCurrentDirectory())に依存するよ。

パス区切り文字: Path.DirectorySeparatorChar

Windowsの区切りは \、Linuxは / を思い出してね。
面倒なことはせず、これらのプロパティを使おう:

  • Path.DirectorySeparatorChar — 現在のOSでの主要なディレクトリ区切り(Windowsでは '\\', Linuxでは '/')。
  • Path.AltDirectorySeparatorChar — 代替の区切り(Windowsでも '/' が動く場合がある)。
  • Path.PathSeparator — 環境変数内でのパス区切り(Windowsでは ';', Linuxでは ':')。

使い方:


Console.WriteLine(Path.DirectorySeparatorChar);     // \  (Windowsでは)
Console.WriteLine(Path.AltDirectorySeparatorChar);  // /  (Windowsでは)
Console.WriteLine(Path.PathSeparator);              // ;  (Windowsでは)

自前でディレクトリを辿るようなコードを書くときには便利だよ!

6. 一時ファイルとディレクトリの扱い

プログラムはときどき一時ファイルが必要になる — 中間結果の保存や、データのアトミックな更新のときとかね。

  • Path.GetTempPath() — システムの一時ファイル用フォルダのパスを返す。
  • Path.GetTempFileName() — ユニークな一時ファイルを作成してそのパスを返す。

例:


string tempDir = Path.GetTempPath();
Console.WriteLine($"一時ファイル用フォルダ: {tempDir}");

string tempFile = Path.GetTempFileName();
Console.WriteLine($"作成された一時ファイル: {tempFile}");

これらを使うと名前衝突やファイルをどこに置くかの悩みから解放されるよ。

7. よくある間違いとおもしろトラブル

まず第一に、単純な文字列連結でパスを作る癖。"folder + \"\\\" + file" って簡単そうだけど、実際はダブルスラッシュやスラッシュの抜け、Linuxでは不正な区切り文字… といった問題が出る。これがバグの温床だ。Path.Combine を使おう。

次に、使えない文字を忘れること。例えばユーザーがファイル名に *(「アスタリスク」)を入れるとエラーになるよ。

それから、相対パスと絶対パスを混同して、プログラムが期待していない場所でファイルを探すことがある(例えば "notebook.txt" が別のフォルダで参照される、みたいな)。

アドバイス: パスに関する操作(結合、解析、拡張子の変更、エラーチェックなど)をする前にまず自問して:「これって Path のメソッドで解決できないかな?」 99% の確率で答えはイエスだ。Microsoft は色んな edge-case(エッジケース)でテスト済みだから、自分で再発明する必要はほとんどないよ。

2
タスク
C# SELF, レベル 39, レッスン 4
ロック未解除
ファイル名と拡張子の取得
ファイル名と拡張子の取得
1
アンケート/クイズ
FileクラスとDirectoryクラス、レベル 39、レッスン 4
使用不可
FileクラスとDirectoryクラス
ファイルシステムの操作
コメント
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION