HOWTO · Csharp

C# でファイル名を変更する方法

この記事では、C# でファイル名を変更する方法を紹介します。Move()メソッドと Copy()メソッドが含まれています。

このページの内容

C#でファイル名を変更する操作は、ファイルを新しいパスへ移動することです。元のパスにファイルを残さない場合は File.Move を使います。元のファイルを残し、新しい名前のファイルも必要な場合は File.Copy を使います。どちらの操作も元のパスと移動先のパスを受け取るため、ファイル名だけを変えるには、同じディレクトリと新しいファイル名を組み合わせます。

以下の例では一時ファイルを作成するため、パスの設定をアプリケーションに合わせて変更できます。提示された実行確認では、どちらの例も正常に完了し、コンソールには何も出力されません。

File.Move でファイル名を変更する

File.Move は、ファイルを元のパスから移動先のパスへ移します。同じディレクトリ内で名前を変更するには、移動先のパスにそのディレクトリと新しいファイル名を指定します。移動が成功すると、ファイルは移動先に置かれ、元のパスからは利用できなくなります。

次の完全なプログラムは一時的な元ファイルを作成し、同じディレクトリ内の新しい名前へ移動してから、一時ディレクトリを削除します。コードと表示されるラベルや出力は英語のままです。

using System;
using System.IO;

class Program
{
    static void Main()
    {
        string directory = Path.Combine(Path.GetTempPath(), Guid.NewGuid().ToString());
        Directory.CreateDirectory(directory);
        string sourcePath = Path.Combine(directory, "old-name.txt");
        string destinationPath = Path.Combine(directory, "new-name.txt");

        try
        {
            File.WriteAllText(sourcePath, "Example content");
            File.Move(sourcePath, destinationPath);
        }
        finally
        {
            Directory.Delete(directory, true);
        }
    }
}

元ファイルが存在し、移動先のパスが使用可能である必要があります。移動先が別のディレクトリにある場合は、名前の変更とともにファイルもそのディレクトリへ移されます。そのため、古いパスからファイルをなくしたい場合に File.Move が適しています。2つ目のコピーは残りません。

File.Copy で名前を変更したコピーを作成する

元のファイルと新しい名前のファイルの両方を残す場合は、File.Copy を使います。第1引数には既存の元ファイルを、第2引数にはコピーの作成先パスを指定します。名前を変えたようなコピーを同じディレクトリに作成することも、別の場所に置くため別のディレクトリを指定することもできます。

次の完全なプログラムは一時的な元ファイルを作成し、新しいファイル名でコピーしてから、格納先ディレクトリごと両方のファイルを削除します。コードと表示されるラベルや出力は英語のままです。

using System;
using System.IO;

class Program
{
    static void Main()
    {
        string directory = Path.Combine(Path.GetTempPath(), Guid.NewGuid().ToString());
        Directory.CreateDirectory(directory);
        string sourcePath = Path.Combine(directory, "old-name.txt");
        string destinationPath = Path.Combine(directory, "new-name.txt");

        try
        {
            File.WriteAllText(sourcePath, "Example content");
            File.Copy(sourcePath, destinationPath);
        }
        finally
        {
            Directory.Delete(directory, true);
        }
    }
}

コピーが成功すると、元ファイルは元のパスに残り、新しいファイルが移動先で利用できるようになります。バックアップや別の処理への入力など、元ファイルを保持する必要がある場合に便利です。コピーには追加の保存領域が必要であり、一方のファイルを後から編集しても、もう一方には自動的に反映されない点に注意してください。

パスと既存の移動先ファイルを扱う

パスには有効な C# 文字列を使います。逐語的文字列リテラルの例 @"C:\\example\\old-name.txt" では、バックスラッシュがエスケープ文字として扱われません。ディレクトリとファイル名からパスを作るには、Path.Combine も実用的です。例では特定のドライブや既存フォルダーに依存しないよう、一時ディレクトリと Path.Combine を使用しています。アプリケーションでは、プロセスがアクセスできるディレクトリを選び、必要に応じてその親ディレクトリが存在することを確認してください。

どちらの操作も、元ファイルが存在しなければ成功しません。ファイル名の入力ミス、想定と異なる作業ディレクトリ、存在しないフォルダーへのパスが原因で、操作に失敗することがあります。可能であれば既知のディレクトリ値からパスを作成し、変更を加える前に、移動またはコピーする対象が意図したファイルであることを確認してください。

既定では、File.Move と File.Copy は、移動先にすでに存在するファイルを上書きしません。移動先の名前がすでに使われている可能性がある場合は、別の名前を選ぶか、操作を呼び出す前にその状態を処理してください。上書き用オーバーロードの利用可否や動作は対象のフレームワークによって異なるため、使用する前にアプリケーションが対象とするフレームワークのドキュメントを確認してください。名前の変更によって既存のファイルが暗黙に置き換えられるとは考えないでください。

要するに、ファイルを新しいパスへ移して元の場所からなくす場合は File.Move を使い、元ファイルを残しながら別に保存された複製を作る場合は File.Copy を使います。どちらを選ぶかは、元のパスに元ファイルを残す必要があるかどうかで決まります。