DirMove

フォルダを、そのサブフォルダやファイルとともに移動します。また、フォルダ名を変更できます。

DirMove Source, Dest , OverwriteOrRename

パラメータ

Source

型:文字列

ソースディレクトリの名前(末尾にバックスラッシュを付けない)。絶対パスが指定されていない場合は、A_WorkingDirにあると仮定されます。事例:C:\My Folder

Dest

型:文字列

絶対パスが指定されていない場合、A_WorkingDirにあると仮定されるディレクトリの新しいパスと名前(末尾にバスクラッシュを付けない)。For example: D:\My Folder.

注意:Destは、移動後のディレクトリが持つ実際のパスと名前であり、Sourceが移動するディレクトリではありません(後述の既知の制限を除きます)。

OverwriteOrRename

型:文字列

省略したときの初期値は0です。Otherwise, specify one of the following values to indicate whether to overwrite or rename existing files:

0:既存ファイルを上書きしません。Destがすでにファイルまたはディレクトリとして存在する場合、操作は失敗します。

1:既存ファイルを上書きします。ただし、Dest内のファイルやサブフォルダで、Sourceに対応するものがないものは削除されません。既知の制限事項: Destがすでにフォルダとして存在し、それがSourceと同じボリュームにある場合、Sourceは上書きされるのではなく、その中に移動されます。これを回避するためには、次のオプションをご覧ください。

2:限定がないことを除き、上記モード1と同じです。

R:ディレクトリを移動するのではなく、名前を変更します。リネームは通常、移動と同じ効果をもたらしますが、「all or none」動作を望む場合、つまり、ソースまたはそのファイルの1つがロック(使用中)されている場合に、操作が部分的にしか成功しないことを望まない場合に便利です。この方法では、Sourceを別のボリュームに移動することはできませんが、自ボリュームの他のディレクトリに移動することは可能です。Destがすでにファイルまたはディレクトリとして存在する場合、操作は失敗します。

エラー処理

エラーが発生した場合は、例外がスローされます。

備考

DirMoveは、1つのフォルダーを新しい場所に移動します。フォルダの内容(すべてのファイルとサブフォルダ)を移動する場合は、FileMoveの例のセクションを参照してください。

移動元と移動先が異なるボリュームまたはUNCパスにある場合は、移動ではなく、コピー/削除操作が実行されます。

DirCopyFileCopyFileMoveFileDeleteファイルループDirSelectSplitPath

ディレクトリを新しいドライブに移動します。

DirMove "C:\My Folder", "D:\My Folder"

単純なリネームを行います。

DirMove "C:\My Folder", "C:\My Folder (renamed)", "R"

ディレクトリは、同じボリュームにある限り、別の場所に「リネーム」することができます。

DirMove "C:\My Folder", "C:\New Location\My Folder", "R"