DirMove

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

DirMove Source, Dest , OverwriteOrRename

パラメータ

Source

型:文字列

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

Dest

型:文字列

絶対パスが指定されていない場合、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).

OverwriteOrRename

型:文字列

省略された場合、デフォルトは 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

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

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"