# FileSetAttrib

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

    FileSetAttrib, Attributes , FilePattern, OperateOnFolders?, Recurse?

## 参数

Attributes

  要改变的属性. 例如, `+HA-R`.

  要方便地打开, 关闭或切换属性, 请分别在以下一个或多个属性字母前加上加号(+), 减号(-) 或脱字符(^):

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

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

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

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

OperateOnFolders?

  如果空白或省略, 则默认为 0(仅对文件进行操作). 否则, 指定下列数字之一:

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

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

  此参数可以为表达式.

递归?

  如果空白或省略, 则默认为 0(不对子文件夹进行递归). 否则, 指定下列数字之一:

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

  此参数可以为表达式.

## 错误处理

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

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

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

## 相关

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

递归 C 盘上的所有 .ini 文件, 并打开它们的 "存档" 属性.

    FileSetAttrib, +A, C:\*.ini, , 1

dftg