FileSystem.MoveFile メソッド

定義

名前空間:

Microsoft.VisualBasic.FileIO

アセンブリ:

Microsoft.VisualBasic.Core.dll

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

オーバーロード

MoveFile(String, String)	ファイルを新しい場所に移動します。
MoveFile(String, String, UIOption)	ファイルを新しい場所に移動します。
MoveFile(String, String, Boolean)	ファイルを新しい場所に移動します。
MoveFile(String, String, UIOption, UICancelOption)	ファイルを新しい場所に移動します。

MoveFile(String, String)

ソース:

FileSystem.vb

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

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

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

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。

ArgumentNullException

destinationFileName が Nothing または空の文字列です。

FileNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

例

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

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

次の使用例は、 から TestDir1 にファイルTest.txtを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)

ソース:

FileSystem.vb

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

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 です。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。

ArgumentNullException

destinationFileName が Nothing または空の文字列です。

FileNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

例

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

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

次の使用例は、 から TestDir1 にファイルTest.txtを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)

こちらもご覧ください

• UIOption

MoveFile(String, String, Boolean)

ソース:

FileSystem.vb

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

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 です。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。

ArgumentNullException

destinationFileName が Nothing または空の文字列です。

FileNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

例

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

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

次の使用例は、 から TestDir1 にファイルTest.txtを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)

ソース:

FileSystem.vb

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

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 です。

例外

ArgumentException

パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。

ArgumentNullException

destinationFileName が Nothing または空の文字列です。

FileNotFoundException

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

IOException

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

OperationCanceledException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

例

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

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

次の使用例は、 から TestDir1 にファイルTest.txtを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)

こちらもご覧ください

• UIOption
• UICancelOption