FileSystemProxy.MoveFile メソッド

定義

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

オーバーロード

MoveFile(String, String)

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

MoveFile(String, String, UIOption)

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

MoveFile(String, String, Boolean)

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

MoveFile(String, String, UIOption, UICancelOption)

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

MoveFile(String, String)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public void MoveFile (string sourceFileName, string destinationFileName);
member this.MoveFile : string * string -> unit
Public 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")

次の使用例は、 から TestDir1 にファイルTest.txtTestDir2移動し、名前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 示します。

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

こちらもご覧ください

適用対象

MoveFile(String, String, UIOption)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public 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")

次の使用例は、 から TestDir1 にファイルTest.txtTestDir2移動し、名前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 示します。

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

こちらもご覧ください

適用対象

MoveFile(String, String, Boolean)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);
member this.MoveFile : string * string * bool -> unit
Public 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")

次の使用例は、 から TestDir1 にファイルTest.txtTestDir2移動し、名前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 示します。

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

こちらもご覧ください

適用対象

MoveFile(String, String, UIOption, UICancelOption)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public 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")

次の使用例は、 から TestDir1 にファイルTest.txtTestDir2移動し、名前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 示します。

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

こちらもご覧ください

適用対象