FileSetAttrib

改变一个或多个文件或文件夹的属性. 支持通配符.

FileSetAttrib, Attributes , FilePattern, OperateOnFolders?, Recurse?

参数

Attributes

要改变的属性(请参阅备注).

FilePattern

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

如果省略, 则使用最内层文件循环的当前文件.

OperateOnFolders?

0(默认) 不对文件夹进行操作(仅文件).
对匹配通配符模式的所有文件和文件夹进行操作.
仅对文件夹进行操作(不操作文件).

注意: 如果 FilePattern 是单个文件夹而不是通配符模式, 那么总是忽略此设置.

此参数可以为表达式.

递归?

0(默认) 不对子文件夹进行递归.
递归子文件夹, 以便对包含在其中的匹配 FilePattern 的所有文件和文件夹进行操作. 将递归所有子文件夹, 而不仅是名称匹配 FilePattern 的那些. 但是, 文件和文件夹的完整路径和名称超过 259 个字符时, 这些文件和文件夹会被跳过, 就像它们不存在一样. 这样的文件很罕见, 因为操作系统一般不允许创建它们.

此参数可以为表达式.

错误处理

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

ErrorLevel 被设置为改变属性 失败 的文件数, 否则为 0.

如果找到了文件, 则 A_LastError 会被设置为 0(零) 或最近一次操作失败时调用操作系统 GetLastError() 函数的结果. 否则 A_LastError 包含了没有找到文件原因的错误码.

备注

Attributes 参数由运算符和属性字母的集合组成.

运算符:

属性字母:
R = 只读
A = 存档
S = 系统
H = 隐藏
N = 普通(仅在单独使用此属性时才有效)
O = 离线
T = 临时

注意: 当前, 此命令无法改变文件的压缩状态.

相关

FileGetAttrib, FileGetTime, FileSetTime, FileGetSize, FileGetVersion, 文件循环

示例

FileSetAttrib, +RH, C:\MyFiles\*.*, 1  ; +RH 等同于 +R+H
FileSetAttrib, ^H, C:\MyFiles  ; 切换文件夹的 "隐藏" 属性.
FileSetAttrib, -R+A, C:\New Text File.txt
FileSetAttrib, +A, C:\*.ini, , 1  ; 递归 C 驱动器上的所有 .ini 文件.