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

My.Computer.FileSystem.MoveFile メソッドを使用すると、ファイルを別のフォルダーに移動できます。移動先が存在しない場合は作成されます。

ファイルを移動するには

• MoveFile メソッドを使用し、ファイル名および移動元と移動先のファイルの場所を指定してファイルを移動します。この例では、test.txt という名前のファイルを TestDir1 から TestDir2 に移動します。移動先ファイル名は、移動元ファイル名と同じであっても指定する点に注意してください。

  My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt",
      "C:\TestDir2\test.txt")
  

ファイルを移動するときに名前を変更するには

• MoveFile メソッドを使用してファイルを移動します。その際、移動元ファイルの名前と場所、移動先の場所、および移動先での新しい名前を指定します。この例では、test.txt という名前のファイルを TestDir1 から TestDir2 に移動し、名前を nexttest.txt に変更します。

  My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt",
      "C:\TestDir2\nexttest.txt",
      FileIO.UIOption.AllDialogs,
      FileIO.UICancelOption.ThrowException)
  

信頼性の高いプログラミング

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

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

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

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

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

• パスを組み合わせると既存のディレクトリと同じになる、移動先のファイルが既に存在し overwrite が False に設定されている、移動先ディレクトリの同名ファイルが使用中である、またはユーザーがファイルにアクセスするのに必要なアクセス許可がない (IOException)。

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

• showUI が True に設定され、onUserCancel が ThrowException に設定されている状態で、ユーザーが操作をキャンセルしたか、または未指定の I/O エラーが発生した (OperationCanceledException)。

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

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

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

参照

処理手順

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

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

方法 : Visual Basic でファイル パスを解析する

関連項目

MoveFile