FileSystem.MoveFile メソッド

定義

ファイルを新しい場所に移動します。

オーバーロード

MoveFile(String, String)

ファイルを新しい場所に移動します。

MoveFile(String, String, UIOption)

ファイルを新しい場所に移動します。

MoveFile(String, String, Boolean)

ファイルを新しい場所に移動します。

MoveFile(String, String, UIOption, UICancelOption)

ファイルを新しい場所に移動します。

MoveFile(String, String)

ファイルを新しい場所に移動します。

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public static void MoveFile (string sourceFileName, string destinationFileName);
static member MoveFile : string * string -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)

パラメーター

sourceFileName
String

移動するファイルのパス。

destinationFileName
String

ファイルの移動先となるディレクトリのパス。

例外

パスが無効です。原因として、パスが長さが 0 の文字列であるか、パスに空白しか含まれていないか、パスに無効な文字が含まれているか、パスがデバイス パスである (\\.\ で始まっている) か、またはパスがスラッシュで終わっていることが考えられます。

destinationFileNameNothing または空の文字列です。

ソース ファイルが有効でないか、存在しません。

他のプロセスがファイルを使用しているか、I/O エラーが発生しました。

パスがシステム定義の最大長を超えています。

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

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

この例では、ファイル Test.txtTestDir1 から TestDir2 に移動します。

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

次の使用例は、ファイルTest.txtの移動元TestDir1``TestDir2と名前を変更しますTest2.txt

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

注釈

ターゲット構造が存在しない場合は、作成されます。

メソッドはMoveFile、同じボリューム内でファイルを移動する場合にのみ、ACE (Access Control エントリ) を保持します。 これには、移動時に直接 ACE になる継承された ACE が含まれます (直接 ACE は継承された ACE よりも優先されます)。 ボリューム間でファイルを移動した場合、ACE はコピーされません。

次の表に、メソッドに関連するタスクの例を My.Computer.FileSystem.MoveFile 示します。

終了 解決方法については、
ファイルを移動する 方法: ファイルを移動する (Visual Basic)

適用対象

MoveFile(String, String, UIOption)

ファイルを新しい場所に移動します。

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

パラメーター

sourceFileName
String

移動するファイルのパス。

destinationFileName
String

ファイルの移動先となるディレクトリのパス。

showUI
UIOption

操作の進行状況を視覚的に追跡するかどうかを指定します。 既定値は UIOption.OnlyErrorDialogs です。

例外

パスが無効です。原因として、パスが長さが 0 の文字列であるか、パスに空白しか含まれていないか、パスに無効な文字が含まれているか、パスがデバイス パスである (\\.\ で始まっている) か、またはパスがスラッシュで終わっていることが考えられます。

destinationFileNameNothing または空の文字列です。

ソース ファイルが有効でないか、存在しません。

他のプロセスがファイルを使用しているか、I/O エラーが発生しました。

パスがシステム定義の最大長を超えています。

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

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

この例では、ファイル Test.txtTestDir1 から TestDir2 に移動します。

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

次の使用例は、ファイルTest.txtの移動元TestDir1``TestDir2と名前を変更しますTest2.txt

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

注釈

ターゲット構造が存在しない場合は、作成されます。

メソッドはMoveFile、同じボリューム内でファイルを移動する場合にのみ、ACE (Access Control エントリ) を保持します。 これには、移動時に直接 ACE になる継承された ACE が含まれます (直接 ACE は継承された ACE よりも優先されます)。 ボリューム間でファイルを移動した場合、ACE はコピーされません。

次の表に、メソッドに関連するタスクの例を My.Computer.FileSystem.MoveFile 示します。

終了 解決方法については、
ファイルを移動する 方法: ファイルを移動する (Visual Basic)

こちらもご覧ください

適用対象

MoveFile(String, String, Boolean)

ファイルを新しい場所に移動します。

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public static void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);
static member MoveFile : string * string * bool -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

パラメーター

sourceFileName
String

移動するファイルのパス。

destinationFileName
String

ファイルの移動先となるディレクトリのパス。

overwrite
Boolean

既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。

例外

パスが無効です。原因として、パスが長さが 0 の文字列であるか、パスに空白しか含まれていないか、パスに無効な文字が含まれているか、パスがデバイス パスである (\\.\ で始まっている) か、またはパスがスラッシュで終わっていることが考えられます。

destinationFileNameNothing または空の文字列です。

ソース ファイルが有効でないか、存在しません。

他のプロセスがファイルを使用しているか、I/O エラーが発生しました。

パスがシステム定義の最大長を超えています。

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

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

この例では、ファイル Test.txtTestDir1 から TestDir2 に移動します。

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

次の使用例は、ファイルTest.txtの移動元TestDir1``TestDir2と名前を変更しますTest2.txt

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

注釈

ターゲット構造が存在しない場合は、作成されます。

メソッドはMoveFile、同じボリューム内でファイルを移動する場合にのみ、ACE (Access Control エントリ) を保持します。 これには、移動時に直接 ACE になる継承された ACE が含まれます (直接 ACE は継承された ACE よりも優先されます)。 ボリューム間でファイルを移動した場合、ACE はコピーされません。

次の表に、メソッドに関連するタスクの例を My.Computer.FileSystem.MoveFile 示します。

終了 解決方法については、
ファイルを移動する 方法: ファイルを移動する (Visual Basic)

適用対象

MoveFile(String, String, UIOption, UICancelOption)

ファイルを新しい場所に移動します。

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

パラメーター

sourceFileName
String

移動するファイルのパス。

destinationFileName
String

ファイルの移動先となるディレクトリのパス。

showUI
UIOption

操作の進行状況を視覚的に追跡するかどうかを指定します。 既定値は UIOption.OnlyErrorDialogs です。

onUserCancel
UICancelOption

ユーザーによって操作が取り消された場合に、例外をスローするかどうかを指定します。 既定値は UICancelOption.ThrowException です。

例外

パスが無効です。原因として、パスが長さが 0 の文字列であるか、パスに空白しか含まれていないか、パスに無効な文字が含まれているか、パスがデバイス パスである (\\.\ で始まっている) か、またはパスがスラッシュで終わっていることが考えられます。

destinationFileNameNothing または空の文字列です。

ソース ファイルが有効でないか、存在しません。

他のプロセスがファイルを使用しているか、I/O エラーが発生しました。

onUserCancelThrowException に設定されている場合に、ユーザーが操作を取り消したか、不特定の I/O エラーが発生しました。

パスがシステム定義の最大長を超えています。

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

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

この例では、ファイル Test.txtTestDir1 から TestDir2 に移動します。

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

次の使用例は、ファイルTest.txtの移動元TestDir1``TestDir2と名前を変更しますTest2.txt

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

注釈

ターゲット構造が存在しない場合は、作成されます。

このメソッドはMoveFile、同じボリューム内でファイルを移動する場合にのみ、ACE (Access Control エントリ) を保持します。 これには、継承された ACE が含まれます。これは、移動時に直接 ACE になります (ダイレクト ACE は継承された ACE よりも優先されます)。 ファイルがボリューム間で移動された場合、ACE はコピーされません。

次の表に、メソッドに関連するタスクの例を My.Computer.FileSystem.MoveFile 示します。

終了 解決方法については、
ファイルを移動する 方法: ファイルを移動する (Visual Basic)

こちらもご覧ください

適用対象