FileSystemProxy.MoveFile メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ファイルを新しい場所に移動します。
オーバーロード
| 名前 | 説明 |
|---|---|
| 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 -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String)パラメーター
- sourceFileName
- String
移動するファイルのパス。
- destinationFileName
- String
ファイルを移動するディレクトリのパス。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。
destinationFileName が Nothing または空の文字列です。
ソース ファイルが無効であるか、存在しません。
ファイルが別のプロセスで使用されているか、I/O エラーが発生します。
パスがシステム定義の最大長を超えています。
パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
例
この例では、ファイル Test.txt を TestDir1 から 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)
Visual Basic
適用対象
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 -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)パラメーター
- sourceFileName
- String
移動するファイルのパス。
- destinationFileName
- String
ファイルを移動するディレクトリのパス。
- showUI
- UIOption
操作の進行状況を視覚的に追跡するかどうかを指定します。 既定値は UIOption.OnlyErrorDialogs です。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。
destinationFileName が Nothing または空の文字列です。
ソース ファイルが無効であるか、存在しません。
ファイルが別のプロセスで使用されているか、I/O エラーが発生します。
パスがシステム定義の最大長を超えています。
パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
例
この例では、ファイル Test.txt を TestDir1 から 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 メソッドを含むタスクの例を示します。
| ターゲット | 参照先 |
|---|---|
| ファイルを移動する | 方法: ファイルを移動する |
こちらもご覧ください
- UIOption
- オブジェクト (Visual Basic)
Visual Basic
適用対象
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 -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)パラメーター
- sourceFileName
- String
移動するファイルのパス。
- destinationFileName
- String
ファイルを移動するディレクトリのパス。
- overwrite
- Boolean
True 既存のファイルを上書きする場合。それ以外の場合は False。 既定値は False です。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。
destinationFileName が Nothing または空の文字列です。
ソース ファイルが無効であるか、存在しません。
ファイルが別のプロセスで使用されているか、I/O エラーが発生します。
パスがシステム定義の最大長を超えています。
パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
例
この例では、ファイル Test.txt を TestDir1 から 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)
Visual Basic
適用対象
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 -> unitPublic 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 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。末尾にスラッシュが付きます。
destinationFileName が Nothing または空の文字列です。
ソース ファイルが無効であるか、存在しません。
ファイルが別のプロセスで使用されているか、I/O エラーが発生します。
onUserCancel が ThrowExceptionに設定され、ユーザーが操作を取り消したか、指定されていない I/O エラーが発生します。
パスがシステム定義の最大長を超えています。
パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
例
この例では、ファイル Test.txt を TestDir1 から 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 メソッドを含むタスクの例を示します。
| ターゲット | 参照先 |
|---|---|
| ファイルを移動する | 方法: ファイルを移動する |
こちらもご覧ください
- UIOption
- UICancelOption
Visual Basic