ファイル

【C#】Path.GetFileNameWithoutExtensionで拡張子を削除するベストプラクティスと例外対策

2025-05-16更新日: 2025-05-16

C#でファイル名から拡張子を削除するなら、System.IO.Path.GetFileNameWithoutExtensionが最短ルートです。

フルパスでも直接ファイル名でも使え、返り値は拡張子なしの文字列。

バージョンやOSに依存せず、nullや空文字列のチェックだけ忘れなければ安全に扱えます。

目次から探す

Path.GetFileNameWithoutExtensionとは
- 役割と特徴
- 返り値の仕様
Pathクラスの基礎
- GetFileNameWithoutExtension と関連メソッド
基本パターン
- 単一ファイルの処理
- 複数ファイルのループ処理
振る舞いの詳細
- 拡張子の判定ルール
- 末尾ドット付きファイル名
例外対策
クロスプラットフォームの注意点
代替アプローチ比較
拡張子を判定せずに一括処理するコレクション操作
- LINQ でのバッチ処理
- Parallel.ForEach での並列処理
よくある落とし穴
サンプルコードのポイント
まとめ

Path.GetFileNameWithoutExtensionとは

役割と特徴

Path.GetFileNameWithoutExtensionは、C#のSystem.IO名前空間に含まれるPathクラスのメソッドの一つです。

このメソッドは、ファイルパスからファイル名を取得し、そのファイル名から拡張子を取り除いた文字列を返します。

ファイルの拡張子を削除したい場合に非常に便利で、ファイル名の操作や表示、ログ出力などでよく使われます。

特徴としては以下の点が挙げられます。

ファイルパス全体からファイル名を抽出

フルパスが与えられた場合でも、パスのディレクトリ部分を除いてファイル名だけを取り出します。

拡張子の自動判別と削除

ファイル名の最後にある拡張子(ドット.以降の文字列)を自動的に検出し、除去します。

拡張子がない場合は元のファイル名をそのまま返します。

拡張子が複数ドットを含む場合の対応

例えばarchive.tar.gzのようなファイル名では、最後の拡張子.gzのみを削除し、archive.tarを返します。

パス区切り文字の違いを吸収

Windowsの\やUnix系の/など、異なるパス区切り文字に対応しています。

例外処理が必要な場合がある

引数にnullや空文字列を渡すと例外が発生するため、事前にチェックが必要です。

このメソッドは、ファイル名の拡張子を簡単に取り除くための標準的な手段として広く利用されています。

自前で文字列操作を行うよりも安全で確実に動作するため、ファイル名の加工にはまずこのメソッドを検討するとよいでしょう。

返り値の仕様

Path.GetFileNameWithoutExtensionの返り値は、入力されたファイルパスに基づいて以下のように決まります。

入力例	返り値	説明
`C:\folder\file.txt`	`file`	拡張子`.txt`を除いたファイル名
`/home/user/archive.tar.gz`	`archive.tar`	最後の拡張子`.gz`のみ削除
`relative/path/to/file`	`file`	拡張子なしのファイル名はそのまま返す
`C:\folder\.gitignore`	`.gitignore`	拡張子がない隠しファイル名はそのまま返す
`C:\folder\file.`	`file`	末尾のドットは拡張子として扱われる
`C:\folder\`	空文字列 `""`	ディレクトリパスのみの場合は空文字列を返す
`null`	例外 `ArgumentNullException`	引数が`null`の場合は例外が発生する
`""`(空文字列)	例外 `ArgumentException`	空文字列の場合も例外が発生する

返り値は常に文字列で、拡張子を除いたファイル名が返されます。

拡張子が存在しない場合は元のファイル名がそのまま返るため、拡張子の有無を気にせず使えます。

また、パスの最後がディレクトリで終わっている場合(例えばC:\folder\)、ファイル名が存在しないため空文字列を返します。

これにより、ファイル名の抽出に失敗したことがわかります。

例外については、引数がnullや空文字列の場合にArgumentNullExceptionやArgumentExceptionがスローされるため、呼び出し前に必ずチェックを行うことが推奨されます。

これにより、予期しない例外発生を防げます。

以上の仕様を理解しておくことで、Path.GetFileNameWithoutExtensionを安全かつ効果的に利用できます。

Pathクラスの基礎

GetFileNameWithoutExtension と関連メソッド

GetExtension

Path.GetExtensionは、ファイルパスから拡張子を取得するメソッドです。

拡張子とは、ファイル名の最後にあるドット.以降の部分を指します。

例えば、file.txtなら拡張子は.txtです。

このメソッドは、拡張子を含む文字列を返します。

拡張子が存在しない場合は空文字列を返します。

拡張子の判定はファイル名の最後のドット以降で行われるため、複数ドットがある場合は最後のドット以降が拡張子とみなされます。

以下はサンプルコードです。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath1 = @"C:\folder\document.pdf";
        string filePath2 = @"C:\folder\archive.tar.gz";
        string filePath3 = @"C:\folder\README";
        // 拡張子を取得
        string ext1 = Path.GetExtension(filePath1);
        string ext2 = Path.GetExtension(filePath2);
        string ext3 = Path.GetExtension(filePath3);
        Console.WriteLine(ext1); // 出力: .pdf
        Console.WriteLine(ext2); // 出力: .gz
        Console.WriteLine(ext3); // 出力: (空文字列)
    }
}

.pdf
.gz

このように、GetExtensionは拡張子の有無を判別したり、拡張子を変更する際の基礎情報として使えます。

GetFileName

Path.GetFileNameは、ファイルパスからファイル名(拡張子を含む)だけを抽出するメソッドです。

ディレクトリ部分を除いたファイル名を返します。

例えば、C:\folder\file.txtを渡すとfile.txtが返ります。

拡張子の有無に関わらずファイル名全体を取得したい場合に使います。

サンプルコードは以下の通りです。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = @"C:\folder\example.data.txt";
        string fileName = Path.GetFileName(filePath);
        Console.WriteLine(fileName); // 出力: example.data.txt
    }
}

example.data.txt

このメソッドは、ファイル名の一部を加工したいときや、拡張子を含めてファイル名を取得したいときに役立ちます。

Combine

Path.Combineは、複数のパス文字列を結合して一つのパスを作成するメソッドです。

手動でパス区切り文字を付ける必要がなく、OSに適した区切り文字を自動で挿入します。

例えば、ディレクトリパスとファイル名を結合してフルパスを作るときに使います。

これにより、パスの区切り文字の重複や不足を防げます。

以下はサンプルコードです。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string dirPath = @"C:\folder\subfolder";
        string fileName = "data.txt";
        string fullPath = Path.Combine(dirPath, fileName);
        Console.WriteLine(fullPath); // 出力: C:\folder\subfolder\data.txt
    }
}

C:\folder\subfolder\data.txt

Path.Combineは複数のパス要素を安全に結合できるため、ファイル操作の際に非常に便利です。

複数の引数を渡すこともでき、例えばPath.Combine("C:\\", "folder", "file.txt")のように使えます。

これらのメソッドを組み合わせることで、ファイルパスの操作を効率的かつ安全に行えます。

特にGetFileNameWithoutExtensionとGetExtensionは拡張子の操作に密接に関係しているため、用途に応じて使い分けることが重要です。

基本パターン

単一ファイルの処理

単一のファイルパスから拡張子を削除してファイル名を取得する基本的な使い方は、Path.GetFileNameWithoutExtensionを直接呼び出すだけで完結します。

ファイルパスが正しく指定されていることを前提に、拡張子を除いたファイル名を簡単に取得できます。

以下は、単一ファイルのパスから拡張子を除いたファイル名を取得し、コンソールに表示するサンプルコードです。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        // 処理対象のファイルパス
        string filePath = @"C:\Users\Public\Documents\report.pdf";
        // 拡張子を除いたファイル名を取得
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
        // 結果を表示
        Console.WriteLine("拡張子を除いたファイル名: " + fileNameWithoutExt);
    }
}

拡張子を除いたファイル名: report

このコードでは、filePathに指定したファイルの拡張子.pdfが除かれ、reportだけが取得されています。

ファイル名に複数のドットが含まれていても、最後の拡張子のみが削除されます。

単一ファイルの処理では、ファイルパスがnullや空文字列でないことを事前にチェックすることが望ましいです。

そうすることで、例外の発生を防ぎ、安定した動作を実現できます。

複数ファイルのループ処理

複数のファイルパスをまとめて処理する場合は、配列やリストなどのコレクションを使い、ループで一つずつPath.GetFileNameWithoutExtensionを呼び出す方法が一般的です。

これにより、複数ファイルの拡張子を一括で除去し、ファイル名だけを取得できます。

以下は、複数のファイルパスを配列で用意し、ループ処理で拡張子を除いたファイル名を取得して表示する例です。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        // 複数のファイルパスを配列で用意
        string[] filePaths = new string[]
        {
            @"C:\Data\image1.jpg",
            @"C:\Data\archive.tar.gz",
            @"C:\Data\document",
            @"C:\Data\.gitignore"
        };
        // ループで一つずつ処理
        foreach (string path in filePaths)
        {
            // nullや空文字列をチェック
            if (string.IsNullOrEmpty(path))
            {
                Console.WriteLine("無効なファイルパスです。");
                continue;
            }
            // 拡張子を除いたファイル名を取得
            string fileNameWithoutExt = Path.GetFileNameWithoutExtension(path);
            // 結果を表示
            Console.WriteLine($"元のパス: {path}");
            Console.WriteLine($"拡張子除去後: {fileNameWithoutExt}");
            Console.WriteLine();
        }
    }
}

元のパス: C:\Data\image1.jpg
拡張子除去後: image1
元のパス: C:\Data\archive.tar.gz
拡張子除去後: archive.tar
元のパス: C:\Data\document
拡張子除去後: document
元のパス: C:\Data\.gitignore
拡張子除去後: .gitignore

この例では、拡張子があるファイルは正しく拡張子が除かれ、拡張子がないファイルや隠しファイル(先頭がドットのファイル)はそのままの名前が返されています。

archive.tar.gzのように複数ドットがある場合は、最後の拡張子.gzだけが削除されていることがわかります。

複数ファイルを扱う際は、ファイルパスの妥当性チェックを行うことで、例外の発生を防ぎつつ安定した処理が可能です。

また、必要に応じてファイルの存在確認やアクセス権限のチェックを組み合わせるとより堅牢なコードになります。

振る舞いの詳細

拡張子の判定ルール

Path.GetFileNameWithoutExtensionが拡張子を判定する際のルールは、ファイル名の最後にあるドット.以降の文字列を拡張子として扱う点にあります。

ただし、ファイル名に複数のドットが含まれている場合や特殊なファイル名の場合は挙動が少し異なります。

複数ドットを含むファイル名

ファイル名に複数のドットが含まれている場合、Path.GetFileNameWithoutExtensionは最後のドット以降を拡張子として認識します。

例えば、archive.tar.gzというファイル名の場合、拡張子は.gzと判定され、archive.tarが返されます。

以下のサンプルコードで挙動を確認できます。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = @"C:\files\archive.tar.gz";
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
        Console.WriteLine(fileNameWithoutExt); // 出力: archive.tar
    }
}

archive.tar

このように、複数ドットがあっても最後のドット以降だけが拡張子として扱われるため、archive.tarの部分はファイル名として残ります。

これは一般的な拡張子の扱いに沿った動作であり、複数拡張子を持つファイルの一部を保持したい場合に便利です。

ただし、複数拡張子を完全に取り除きたい場合は、GetFileNameWithoutExtensionを複数回呼び出すか、カスタムの文字列処理を行う必要があります。

隠しファイル .gitignore の扱い

Unix系のシステムでよく使われる隠しファイルは、ファイル名の先頭にドットが付いています。

例えば.gitignoreや.envなどです。

これらのファイルは拡張子を持たないことが多いですが、Path.GetFileNameWithoutExtensionは先頭のドットを拡張子とはみなしません。

そのため、.gitignoreのようなファイル名を渡すと、拡張子を除去せずにそのまま返します。

以下のサンプルコードで確認できます。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = @"/home/user/.gitignore";
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
        Console.WriteLine(fileNameWithoutExt); // 出力: .gitignore
    }
}

.gitignore

この挙動は、先頭のドットを拡張子の区切りと誤認しないように設計されているためです。

隠しファイルの名前を正しく扱いたい場合は、この仕様を理解しておくことが重要です。

末尾ドット付きファイル名

Windows環境では、ファイル名の末尾にドットが付くことがあります。

例えばfile.のような名前です。

Path.GetFileNameWithoutExtensionはこの末尾のドットを拡張子の区切りとみなし、ドットの後に拡張子がない場合でもドットを除去します。

つまり、file.というファイル名を渡すと、拡張子が空であっても末尾のドットは削除され、fileが返されます。

以下のサンプルコードで挙動を確認できます。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = @"C:\temp\file.";
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
        Console.WriteLine(fileNameWithoutExt); // 出力: file
    }
}

file

この仕様はWindowsのファイルシステムの制約に由来しており、末尾のドットはファイル名の一部として扱われないことが多いためです。

LinuxやmacOSなどのUnix系システムでは末尾ドットの扱いが異なる場合があるため、クロスプラットフォームでの動作を考慮する際は注意が必要です。

まとめると、Path.GetFileNameWithoutExtensionは拡張子の判定において以下のように振る舞います。

最後のドット以降を拡張子とみなす(複数ドットがあっても最後のドットのみ)
先頭のドットは拡張子の区切りとみなさず、隠しファイル名はそのまま返す
末尾のドットは拡張子の区切りとして扱い、拡張子が空でもドットを除去する(主にWindows環境)

これらの仕様を理解しておくことで、ファイル名の拡張子処理を正確に行えます。

例外対策

nullチェックと空文字チェック

Path.GetFileNameWithoutExtensionを使用する際に最も基本的な例外対策は、引数として渡すファイルパスがnullや空文字列でないかを事前にチェックすることです。

これを怠ると、ArgumentNullExceptionやArgumentExceptionが発生し、プログラムが予期せず停止する可能性があります。

以下のようにstring.IsNullOrEmptyメソッドを使ってチェックするのが一般的です。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = null; // ここを空文字列 "" にしても同様
        if (string.IsNullOrEmpty(filePath))
        {
            Console.WriteLine("ファイルパスがnullまたは空文字列です。処理を中断します。");
            return;
        }
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
        Console.WriteLine(fileNameWithoutExt);
    }
}

ファイルパスがnullまたは空文字列です。処理を中断します。

このように、無効な入力を事前に検出して処理を分岐させることで、例外の発生を防ぎ安全にメソッドを利用できます。

無効な文字パターン

Windowsや他のOSでは、ファイル名やパスに使用できない文字が存在します。

例えば、Windowsでは以下の文字はファイル名に使えません。

禁止文字	説明
`"`	ダブルクォーテーション
`<`	小なり記号
`>`	大なり記号
`\|`	パイプ
`?`	クエスチョンマーク
`*`	アスタリスク
`:`	コロン
`\`	バックスラッシュ
`/`	スラッシュ

Path.GetFileNameWithoutExtensionに無効な文字を含むパスを渡すと、ArgumentExceptionが発生することがあります。

これを防ぐために、Path.GetInvalidPathCharsやPath.GetInvalidFileNameCharsを使って事前にチェックする方法があります。

以下は無効文字を検出するサンプルコードです。

using System;
using System.IO;
using System.Linq;
class Program
{
    static void Main()
    {
        string filePath = @"C:\folder\invalid|name.txt";
        // 無効な文字を取得
        char[] invalidChars = Path.GetInvalidPathChars().Concat(Path.GetInvalidFileNameChars()).Distinct().ToArray();
        if (filePath.Any(c => invalidChars.Contains(c)))
        {
            Console.WriteLine("ファイルパスに無効な文字が含まれています。");
            return;
        }
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
        Console.WriteLine(fileNameWithoutExt);
    }
}

ファイルパスに無効な文字が含まれています。

このように無効文字を検出して処理を中断することで、例外の発生を未然に防げます。

PathTooLongException の回避

Windowsのファイルシステムにはパスの長さ制限があり、通常は最大260文字(MAX_PATH)までです。

これを超えるパスを扱おうとすると、PathTooLongExceptionが発生します。

Path.GetFileNameWithoutExtension自体はパスの長さを直接検証しませんが、長すぎるパスを渡すと内部で例外が発生する可能性があります。

特に長いパスを扱う場合は、事前にパスの長さをチェックし、必要に応じてパスを短縮するか、Windowsの長いパスサポートを有効にする必要があります。

パス長チェックの例は以下の通りです。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = @"C:\very\long\path\..."; // 実際には260文字以上のパスを指定
        if (filePath.Length > 260)
        {
            Console.WriteLine("パスが長すぎます。処理を中断します。");
            return;
        }
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
        Console.WriteLine(fileNameWithoutExt);
    }
}

パスが長すぎます。処理を中断します。

.NET Coreや.NET 5以降では長いパスのサポートが改善されていますが、環境によっては制限があるため注意が必要です。

UnauthorizedAccessException の考慮

Path.GetFileNameWithoutExtension自体はファイルの存在確認やアクセスを行わないため、通常はUnauthorizedAccessExceptionを直接スローしません。

しかし、ファイルパスの操作やファイルアクセスを伴う処理と組み合わせる場合は、アクセス権限が不足しているとUnauthorizedAccessExceptionが発生することがあります。

例えば、ファイルの存在チェックや読み込みを行う際に権限がないと例外が発生します。

したがって、Path.GetFileNameWithoutExtensionを使う前後でファイルアクセスを行う場合は、例外処理を適切に実装することが重要です。

以下はファイルの存在確認と例外処理を組み合わせた例です。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = @"C:\protected\secret.txt";
        try
        {
            if (!File.Exists(filePath))
            {
                Console.WriteLine("ファイルが存在しません。");
                return;
            }
            string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
            Console.WriteLine(fileNameWithoutExt);
        }
        catch (UnauthorizedAccessException)
        {
            Console.WriteLine("ファイルへのアクセス権限がありません。");
        }
        catch (Exception ex)
        {
            Console.WriteLine("予期せぬエラーが発生しました: " + ex.Message);
        }
    }
}

ファイルへのアクセス権限がありません。

このように、ファイルアクセスを伴う処理ではUnauthorizedAccessExceptionをキャッチして適切に対応することが求められます。

Path.GetFileNameWithoutExtension単体では発生しにくい例外ですが、実際のファイル操作と組み合わせる際は注意してください。

クロスプラットフォームの注意点

Windows と Unix 系でのパス区切り

WindowsとUnix系(LinuxやmacOSなど)では、ファイルパスの区切り文字が異なります。

Windowsはバックスラッシュ\を使い、Unix系はスラッシュ/を使います。

Path.GetFileNameWithoutExtensionはこれらの違いを内部で吸収し、どちらの区切り文字でも正しくファイル名を抽出できます。

例えば、以下のようにWindows形式のパスとUnix形式のパスを渡しても、同じように拡張子を除いたファイル名を取得できます。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string windowsPath = @"C:\folder\example.txt";
        string unixPath = "/home/user/example.txt";
        string fileNameWin = Path.GetFileNameWithoutExtension(windowsPath);
        string fileNameUnix = Path.GetFileNameWithoutExtension(unixPath);
        Console.WriteLine(fileNameWin);   // 出力: example
        Console.WriteLine(fileNameUnix);  // 出力: example
    }
}

example
example

ただし、パスの結合や分割を行う際は、Path.CombineやPath.DirectorySeparatorCharを使うことで、プラットフォームに依存しないコードを書けます。

手動で区切り文字を指定すると、環境によって動作が異なる可能性があるため注意が必要です。

case sensitivity の違い

Windowsのファイルシステムは基本的に大文字・小文字を区別しません(case-insensitive)ので、example.TXTとexample.txtは同じファイルとして扱われます。

一方、Unix系のファイルシステムは大文字・小文字を区別します(case-sensitive)ので、example.TXTとexample.txtは別のファイルです。

Path.GetFileNameWithoutExtensionは文字列操作のメソッドであり、ファイルシステムの大文字・小文字の扱いには影響されません。

つまり、入力されたパスの文字列をそのまま処理します。

そのため、ファイル名の比較や検索を行う場合は、プラットフォームの特性に応じて大文字・小文字の扱いを考慮する必要があります。

例えば、Windows環境であれば大文字・小文字を無視して比較し、Unix系環境では区別するように実装することが望ましいです。

マルチバイト文字の扱い

日本語や中国語、韓国語などのマルチバイト文字を含むファイル名も、Path.GetFileNameWithoutExtensionは問題なく処理できます。

これは、.NETの文字列がUnicodeをサポートしているためです。

以下の例では、日本語のファイル名から拡張子を除去しています。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = @"C:\データ\レポート2024.pdf";
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
        Console.WriteLine(fileNameWithoutExt); // 出力: レポート2024
    }
}

レポート2024

ただし、マルチバイト文字を含むパスを扱う際は、ファイルシステムや環境によっては文字コードの違いや正規化の問題が発生することがあります。

特にファイル名の比較や検索を行う場合は、Unicode正規化(Normalization)を意識した処理を検討するとよいでしょう。

まとめると、Path.GetFileNameWithoutExtensionはクロスプラットフォームでの基本的な文字列処理に対応していますが、パス区切り文字の違いや大文字・小文字の扱い、マルチバイト文字の正規化など、環境依存の要素は別途考慮が必要です。

代替アプローチ比較

Path.ChangeExtension を使う方法

Path.ChangeExtensionは、ファイルパスの拡張子を変更または削除するためのメソッドです。

拡張子を削除したい場合は、第2引数にnullを渡すことで拡張子を取り除いたパスを取得できます。

Path.GetFileNameWithoutExtensionと異なり、ファイル名だけでなくパス全体を返す点に注意が必要です。

以下は拡張子を削除する例です。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = @"C:\folder\example.txt";
        // 拡張子を削除(nullを指定)
        string pathWithoutExt = Path.ChangeExtension(filePath, null);
        Console.WriteLine(pathWithoutExt); // 出力: C:\folder\example
    }
}

C:\folder\example

この方法は、ファイル名だけでなくパス全体を扱いたい場合に便利です。

ただし、ファイル名だけを取得したい場合は、Path.GetFileNameWithoutExtensionと組み合わせて使う必要があります。

例えば、ファイル名だけを取得したい場合は以下のようにします。

string fileNameWithoutExt = Path.GetFileName(Path.ChangeExtension(filePath, null));

Regex によるカスタム削除

正規表現(Regex)を使って拡張子をカスタムに削除する方法もあります。

Path.GetFileNameWithoutExtensionは最後のドット以降を拡張子とみなしますが、特定のルールで拡張子を除去したい場合や複数拡張子を一括で削除したい場合に有効です。

例えば、複数拡張子(.tar.gzなど)をすべて削除したい場合は、以下のように正規表現を使えます。

using System;
using System.Text.RegularExpressions;
class Program
{
    static void Main()
    {
        string fileName = "archive.tar.gz";
        // 複数拡張子をすべて削除する正規表現
        string pattern = @"(\.[^\.]+)+$";
        string result = Regex.Replace(fileName, pattern, "");
        Console.WriteLine(result); // 出力: archive
    }
}

archive

この正規表現は、ファイル名の末尾に連続するドットと拡張子の組み合わせをすべてマッチさせて削除します。

Path.GetFileNameWithoutExtensionでは一度に1つの拡張子しか削除できないため、複数拡張子を完全に取り除きたい場合に役立ちます。

ただし、正規表現はパフォーマンス面でやや重くなることがあるため、処理対象が大量の場合は注意が必要です。

Span<char> での高速化手法

C# 7.2以降で利用可能なSpan<char>を使うと、文字列の部分操作を効率的に行えます。

Path.GetFileNameWithoutExtensionは便利ですが、内部で文字列のコピーが発生するため、大量のファイル名を高速に処理したい場合はSpan<char>を使ったカスタム実装が有効です。

以下は、Span<char>を使って拡張子を除去する簡単な例です。

using System;
class Program
{
    static void Main()
    {
        string fileName = "example.tar.gz";
        ReadOnlySpan<char> span = fileName.AsSpan();
        int lastDotIndex = span.LastIndexOf('.');
        if (lastDotIndex == -1)
        {
            Console.WriteLine(fileName); // 拡張子なし
            return;
        }
        // 拡張子を除いた部分をスライス
        ReadOnlySpan<char> withoutExt = span.Slice(0, lastDotIndex);
        Console.WriteLine(withoutExt.ToString()); // 出力: example.tar
    }
}

example.tar

この方法は文字列のコピーを最小限に抑え、メモリ効率が良いためパフォーマンス向上に寄与します。

特に大量のファイル名を処理するバッチ処理やリアルタイム処理で効果的です。

ただし、Span<char>はスタック上のメモリを扱うため、扱いに注意が必要で、APIの互換性やコードの可読性を考慮して使うことが望ましいです。

これらの代替手法は、用途やパフォーマンス要件に応じて使い分けるとよいでしょう。

標準的な用途ではPath.GetFileNameWithoutExtensionが簡単で安全ですが、複雑な拡張子処理や高速化が必要な場合はこれらの方法を検討してください。

拡張子を判定せずに一括処理するコレクション操作

LINQ でのバッチ処理

複数のファイルパスを一括で処理し、拡張子を除いたファイル名をまとめて取得したい場合、LINQ(Language Integrated Query)を使うと簡潔かつ読みやすいコードが書けます。

LINQのSelectメソッドを使って、コレクション内の各ファイルパスに対してPath.GetFileNameWithoutExtensionを適用し、新しいコレクションを生成します。

以下は、ファイルパスの配列から拡張子を除いたファイル名のリストを作成し、順に表示する例です。

using System;
using System.IO;
using System.Linq;
class Program
{
    static void Main()
    {
        string[] filePaths = new string[]
        {
            @"C:\Data\report.docx",
            @"C:\Data\image.png",
            @"C:\Data\archive.tar.gz",
            @"C:\Data\README"
        };
        // LINQで拡張子を除いたファイル名を一括取得
        var fileNamesWithoutExt = filePaths
            .Where(path => !string.IsNullOrEmpty(path)) // nullや空文字列を除外
            .Select(path => Path.GetFileNameWithoutExtension(path))
            .ToList();
        // 結果を表示
        foreach (var name in fileNamesWithoutExt)
        {
            Console.WriteLine(name);
        }
    }
}

report
image
archive.tar
README

このコードでは、Whereで無効なパスを除外し、Selectで拡張子を除去したファイル名を取得しています。

ToListで結果をリスト化し、後続の処理で使いやすくしています。

LINQを使うことで、コードがシンプルになり、可読性が向上します。

また、条件を追加したり、他の変換処理を組み合わせるのも容易です。

Parallel.ForEach での並列処理

大量のファイルパスを高速に処理したい場合は、Parallel.ForEachを使った並列処理が効果的です。

Parallel.ForEachは複数のスレッドを使ってコレクションの要素を並列に処理するため、CPUコアを有効活用できます。

以下は、Parallel.ForEachでファイルパスの拡張子を除去し、スレッドセーフなコレクションに結果を格納する例です。

using System;
using System.Collections.Concurrent;
using System.IO;
using System.Threading.Tasks;
class Program
{
    static void Main()
    {
        string[] filePaths = new string[]
        {
            @"C:\Data\report.docx",
            @"C:\Data\image.png",
            @"C:\Data\archive.tar.gz",
            @"C:\Data\README"
        };
        var results = new ConcurrentBag<string>();
        Parallel.ForEach(filePaths, path =>
        {
            if (!string.IsNullOrEmpty(path))
            {
                string fileNameWithoutExt = Path.GetFileNameWithoutExtension(path);
                results.Add(fileNameWithoutExt);
            }
        });
        // 結果を表示(順序は保証されない)
        foreach (var name in results)
        {
            Console.WriteLine(name);
        }
    }
}

archive.tar
image
report
README

ConcurrentBag<T>はスレッドセーフなコレクションで、複数スレッドから同時に要素を追加できます。

Parallel.ForEach内で安全に結果を格納できるため、並列処理に適しています。

注意点として、Parallel.ForEachは処理の順序を保証しません。

順序が重要な場合は、PartitionerやPLINQのAsOrderedなどを検討してください。

このように、Parallel.ForEachを使うことで大量のファイル名処理を効率化でき、処理時間の短縮が期待できます。

CPUリソースを有効活用したい場合におすすめの手法です。

よくある落とし穴

拡張子が無いファイルへの誤操作

Path.GetFileNameWithoutExtensionは拡張子が存在しないファイル名に対しては、元のファイル名をそのまま返します。

これ自体は仕様通りの動作ですが、拡張子がないファイルを誤って拡張子付きファイルと同様に扱うと、意図しない処理結果になることがあります。

例えば、拡張子がないファイルに対して拡張子を除去した結果を使って新たなファイル名を生成すると、元の名前と同じになるため、ファイルの上書きや重複が発生しやすくなります。

以下の例を見てみましょう。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = @"C:\Data\README"; // 拡張子なしファイル
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
        Console.WriteLine(fileNameWithoutExt); // 出力: README
        // 拡張子を付けて新しいファイル名を作成
        string newFileName = fileNameWithoutExt + ".txt";
        Console.WriteLine(newFileName); // 出力: README.txt
    }
}

README
README.txt

この場合、元のファイルは拡張子なしのREADMEですが、新たに.txtを付けたファイル名を作ると、同じディレクトリにREADME.txtが存在しないか確認しないと、ファイルの重複や誤操作が起こる可能性があります。

対策としては、拡張子の有無を事前に確認し、必要に応じて処理を分けることが重要です。

Path.GetExtensionで拡張子の有無をチェックし、拡張子がない場合は特別な処理を行うなどの工夫が求められます。

ディレクトリ名を誤って渡すケース

Path.GetFileNameWithoutExtensionはファイルパスからファイル名を抽出し、拡張子を除去するメソッドですが、誤ってディレクトリパスを渡してしまうケースがあります。

この場合、返り値は空文字列になるため、後続の処理で想定外の動作を引き起こすことがあります。

例えば、以下のようなコードです。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string dirPath = @"C:\Data\Folder\"; // ディレクトリパス(末尾に区切り文字)
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(dirPath);
        Console.WriteLine($"結果: '{fileNameWithoutExt}'"); // 出力: ''
    }
}

結果: ''

このように、ディレクトリパスを渡すと空文字列が返るため、ファイル名として扱うとエラーや不正なファイル名生成につながります。

対策としては、ファイルかディレクトリかを事前に判定することが有効です。

File.ExistsやDirectory.Existsを使って存在確認を行い、ディレクトリの場合は処理をスキップするか別の処理を行うようにしましょう。

ドットを含むフォルダ名とファイル名混同

フォルダ名やファイル名にドット.が含まれている場合、Path.GetFileNameWithoutExtensionの挙動に注意が必要です。

特に、フォルダ名にドットが含まれていると、ファイル名の拡張子判定と混同しやすくなります。

例えば、以下のパスを考えます。

C:\Data\version1.0\file.txt

この場合、Path.GetFileNameWithoutExtensionに渡すパスが正しくファイル名を指していれば問題ありませんが、誤ってフォルダ名を含むパス全体を処理対象にすると、意図しない結果になることがあります。

また、フォルダ名にドットが含まれている場合でも、GetFileNameWithoutExtensionは最後のドット以降を拡張子として扱うため、ファイル名の一部が誤って削除されることはありませんが、パスの切り出しを誤ると混乱が生じます。

以下の例で確認します。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = @"C:\Data\version1.0\file.txt";
        string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
        Console.WriteLine(fileNameWithoutExt); // 出力: file
    }
}

file

このように、GetFileNameWithoutExtensionはファイル名部分のみを正しく抽出しますが、パスの扱いを誤るとフォルダ名のドットと混同してしまう恐れがあります。

対策としては、ファイルパスの構造を正確に把握し、ファイル名だけを対象に処理を行うことが重要です。

Path.GetFileNameやPath.GetFileNameWithoutExtensionを使う前に、パスの妥当性を検証し、ディレクトリとファイルを正しく区別することが求められます。

サンプルコードのポイント

入力前検証サンプル

Path.GetFileNameWithoutExtensionを安全に使うためには、入力となるファイルパスの検証が重要です。

特にnullや空文字列、無効な文字を含むパスを渡すと例外が発生するため、事前にチェックしておくことで安定した動作を実現できます。

以下は、入力前にファイルパスの妥当性を検証するサンプルコードです。

using System;
using System.IO;
using System.Linq;
class Program
{
    static void Main()
    {
        string filePath = @"C:\Data\example.txt";
        if (IsValidPath(filePath))
        {
            string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
            Console.WriteLine("拡張子を除いたファイル名: " + fileNameWithoutExt);
        }
        else
        {
            Console.WriteLine("無効なファイルパスです。");
        }
    }
    // ファイルパスの妥当性をチェックするメソッド
    static bool IsValidPath(string path)
    {
        if (string.IsNullOrEmpty(path))
            return false;
        char[] invalidChars = Path.GetInvalidPathChars().Concat(Path.GetInvalidFileNameChars()).Distinct().ToArray();
        return !path.Any(c => invalidChars.Contains(c));
    }
}

拡張子を除いたファイル名: example

このコードでは、IsValidPathメソッドでnullや空文字列のチェックに加え、無効な文字が含まれていないかを検証しています。

これにより、Path.GetFileNameWithoutExtensionに安全な文字列だけを渡せるようになります。

try-catch 例

例外が発生する可能性がある場合は、try-catchブロックで例外を捕捉し、適切に処理することが重要です。

特に外部からの入力やファイルパスの不確定な場合は、例外処理を実装しておくと堅牢なコードになります。

以下は、Path.GetFileNameWithoutExtensionを使う際に例外を捕捉する例です。

using System;
using System.IO;
class Program
{
    static void Main()
    {
        string filePath = null; // nullを意図的に設定
        try
        {
            string fileNameWithoutExt = Path.GetFileNameWithoutExtension(filePath);
            Console.WriteLine("拡張子を除いたファイル名: " + fileNameWithoutExt);
        }
        catch (ArgumentNullException)
        {
            Console.WriteLine("ファイルパスがnullです。");
        }
        catch (ArgumentException ex)
        {
            Console.WriteLine("無効なファイルパスです: " + ex.Message);
        }
        catch (Exception ex)
        {
            Console.WriteLine("予期せぬエラーが発生しました: " + ex.Message);
        }
    }
}

ファイルパスがnullです。

この例では、nullや無効な文字列による例外を個別に捕捉し、ユーザーにわかりやすいメッセージを表示しています。

予期しない例外もキャッチしてログ出力や通知に活用できます。

メソッド抽象化と再利用

拡張子を除去する処理を複数箇所で使う場合は、メソッドとして抽象化し再利用性を高めることが望ましいです。

入力検証や例外処理も含めて一つのメソッドにまとめると、コードの重複を減らし保守性が向上します。

以下は、拡張子を除去したファイル名を安全に取得するメソッドの例です。

using System;
using System.IO;
using System.Linq;
class Program
{
    static void Main()
    {
        string[] filePaths = new string[]
        {
            @"C:\Data\file1.txt",
            null,
            @"C:\Data\invalid|name.doc",
            @"C:\Data\file2.pdf"
        };
        foreach (var path in filePaths)
        {
            string result = GetSafeFileNameWithoutExtension(path);
            Console.WriteLine(result ?? "無効なファイルパス");
        }
    }
    // 拡張子を除去したファイル名を安全に取得するメソッド
    static string GetSafeFileNameWithoutExtension(string path)
    {
        if (string.IsNullOrEmpty(path))
            return null;
        char[] invalidChars = Path.GetInvalidPathChars().Concat(Path.GetInvalidFileNameChars()).Distinct().ToArray();
        if (path.Any(c => invalidChars.Contains(c)))
            return null;
        try
        {
            return Path.GetFileNameWithoutExtension(path);
        }
        catch
        {
            return null;
        }
    }
}

file1
無効なファイルパス
無効なファイルパス
file2

このメソッドは、入力の妥当性チェックと例外処理を内包しており、呼び出し側は戻り値がnullかどうかで判定できます。

こうした抽象化により、コードの安全性と可読性が向上し、再利用も容易になります。

まとめ

この記事では、C#のPath.GetFileNameWithoutExtensionメソッドを使ってファイル名から拡張子を削除する基本的な使い方から、例外対策やクロスプラットフォームの注意点、代替手法まで幅広く解説しました。

入力検証や例外処理を適切に行うことで安全に利用でき、LINQや並列処理を活用すれば大量ファイルの効率的な処理も可能です。

拡張子の判定ルールやよくある落とし穴を理解し、用途に応じて最適な方法を選ぶことが重要です。