フォルダを、そのサブフォルダやファイルとともに移動します。また、フォルダの名前を変更することも可能です。
DirMove Source, Dest , OverwriteOrRename
型:文字列
ソースディレクトリの名前(末尾にバックスラッシュを付けない)。絶対パスが指定されていない場合は、A_WorkingDirにあると仮定されます。事例:C:\My Folder
型:文字列
絶対パスが指定されていない場合、A_WorkingDirにあると仮定されるディレクトリの新しいパスと名前(末尾にバスクラッシュを付けない)。事例:D:\My Folder.
Note: Dest is the actual path and name that the directory will have after it is moved; it is not the directory into which Source is moved (except for the known limitation mentioned below).
型:文字列
省略された場合、デフォルトは 0 です。Otherwise, specify one of the following values to indicate whether to overwrite or rename existing files:
0: Do not overwrite existing files. Destがすでにファイルまたはディレクトリとして存在する場合、操作は失敗します。
1: Overwrite existing files. ただし、Dest内のファイルやサブフォルダで、Sourceに対応するものがないものは削除されません。既知の制限事項: Destがすでにフォルダとして存在し、それがSourceと同じボリュームにある場合、Sourceは上書きされるのではなく、その中に移動されます。これを回避するためには、次のオプションをご覧ください。
2: The same as mode 1 above except that the limitation is absent.
R: Rename the directory rather than moving it. リネームは通常、移動と同じ効果をもたらしますが、「all or none」動作を望む場合、つまり、ソースまたはそのファイルの1つがロック(使用中)されている場合に、操作が部分的にしか成功しないことを望まない場合に便利です。この方法では、Sourceを別のボリュームに移動することはできませんが、自ボリュームの他のディレクトリに移動することは可能です。Destがすでにファイルまたはディレクトリとして存在する場合、操作は失敗します。
エラーが発生した場合は、例外がスローされます。
DirMoveは、1つのフォルダーを新しい場所に移動します。フォルダの内容(すべてのファイルとサブフォルダ)を移動する場合は、FileMoveの例のセクションを参照してください。
移動元と移動先が異なるボリュームまたはUNCパスにある場合は、移動ではなく、コピー/削除操作が実行されます。
DirCopy, FileCopy, FileMove, FileDelete, file loops, DirSelect, SplitPath