方法 : Visual Basic でファイルの名前を変更する

更新 : 2007 年 11 月

My.Computer.FileSystem オブジェクトの RenameFile メソッドを使用すると、ファイルの現在の位置、現在のファイル名、および新しいファイル名を指定して、ファイルの名前を変更できます。このメソッドでは、ファイルを移動することはできません。ファイルを移動して名前を変更するには、MoveFile メソッドを使用します。

ファイルの名前を変更するには

  • My.Computer.FileSystem.RenameFile メソッドを使用してファイルの名前を変更します。この例では、Test.txt というファイル名を SecondTest.txt に変更します。

    ' Change "c:\test.txt" to the path and filename for the file that
    ' you want to rename.
    My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")
    

このコードの例は、IntelliSense コード スニペットとしても利用できます。コード スニペット ピッカーでは、このスニペットは [ファイル システム - ドライブ、フォルダ、およびファイルの処理] にあります。詳細については、「方法 : コードにスニペットを挿入する (Visual Basic)」を参照してください。

堅牢性の高いプログラム

次の条件を満たす場合は、例外が発生する可能性があります。

  • パスが無効である。1) 長さが 0 の文字列である、2) 空白だけが含まれている、3) 無効な文字が含まれている、4) デバイス パスである (\\.\ で開始されている)、のいずれかの理由が考えられる (ArgumentException)。

  • newName にパス情報が含まれている (ArgumentException)。

  • パスが Nothing であるため、有効でない (ArgumentNullException)。

  • newName が Nothing または空の文字列である (ArgumentNullException)。

  • ソース ファイルが有効でないか、または存在しない (FileNotFoundException)。

  • newName で指定したのと同じ名前のファイルまたはディレクトリが既に存在する (IOException)。

  • パスがシステムで定義されている最大長を越えている (PathTooLongException)。

  • パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、または形式が無効である (NotSupportedException)。

  • ユーザーがパスを参照するのに必要なアクセス許可がない (SecurityException)。

  • ユーザーに必要なアクセス許可がない (UnauthorizedAccessException)。

参照

処理手順

方法 : Visual Basic でファイルを移動する

方法 : Visual Basic でファイルのコレクションを移動する

方法 : Visual Basic でファイルのコピーを同じディレクトリに作成する

方法 : Visual Basic でファイルのコピーを別のディレクトリに作成する

参照

My.Computer.FileSystem.RenameFile メソッド

その他の技術情報

Visual Basic でのファイルおよびディレクトリの作成、削除、および移動