# FileRecycle

如果可能, 发送文件或目录到回收站, 否则永久删除.

    FileRecycle, FilePattern

## 参数

FilePattern

  单个文件的名称或通配符模式, 例如 C:\Temp\*.tmp. 如果未指定绝对路径, 则假定 FilePattern 在 %A_WorkingDir% 中.

  要回收整个目录, 请指定不包含末尾反斜杠的目录名.

## 错误处理

[v1.1.04+]: 此命令失败时会抛出异常. 想了解更多信息, 请参阅运行时错误.

如果遇到问题则 ErrorLevel 被置为 1, 否则为 0.

## 备注

实际使用 SHFileOperation 进行操作. 如果由于文件过大而无法存放到回收站, 那么此功能还会永久地删除文件; 自 [v1.0.96] 开始, 在遇到这种情况时会显示警告.

如果文件因为其他原因不能被回收, 则可能会被永久删除而没有警告, 例如:

- 该文件在一个可移动的驱动器上(例如 U 盘文件).
- 回收站已被禁用, 例如通过 `NukeOnDelete` 注册表值.

## 相关

FileRecycleEmpty, FileDelete, FileCopy, FileMove

## 示例

将目录中的所有 .tmp 文件发送到回收站(如果可能).

    FileRecycle, C:\temp files\*.tmp

dftg