文件系统监控

监控文件创建/变更/删除等事件。

当前模块定义​

监控指定文件夹下文件或目录的变化（创建/删除/变更/重命名）。（1.31.0+版本提供。欢迎反馈问题）

支持两种工作方式：

1）等待事件发生后继续运行动作。

2）持续监控，事件发生后调用设定好的子程序。

本模块内部使用了FileSystemWatcher类，如有需要请参考微软官方文档。

等待事件发生​

【操作类型】选择“等待事件发生”。

类似于“等待剪贴板改变”模块，等待目录中发生预期的事件后继续运行动作的后续步骤。

参数

【文件夹路径】需要监控的文件夹路径。

【包含子文件夹】是否监控子文件夹。

【文件筛选】设定需要监控的文件或文件夹。

支持使用通配符*(匹配任意多字符)和?(匹配单个字符)。对应于FileSystemWatcher.Filter属性。

• 监控所有文件：*.* (不支持无后缀文件）
• 监控所有的文件（或子文件夹）：留空。
• 监控某类型文件：填写“*.后缀”，如 *.txt 。不支持使用多个筛选器，例如“*.txt|*.doc”。
• 以“recipe”结尾的所有doc文件：*recipe.doc
• 以“win”开头的所有xml文件：win*.xml
• 监控某个特定的文件：填写文件名，如MyDoc.txt
• 监控某些特定文件：使用通配符，如销售*202?.xlsx匹配 “销售_北方区2021.xslx”、“销售_南方2022.xslx”等。

【通知筛选】设定要监控的变更类型，对应于FileSystemWatcher.NotifyFilter属性。

可以为使用英文半角逗号(,)连接的这些选项的组合：

• Attributes 文件或文件夹的属性
• CreationTime 文件或文件夹的创建时间
• DirectoryName 文件夹的名称
• FileName 文件的名称
• LastAccess 文件或文件夹的最后打开时间
• LastWrite 文件或文件夹的最后写入时间
• Security 文件或文件夹的安全设置
• Size 文件或文件夹的大小

留空时表示默认值 LastWrite,FileName,DirectoryName。

【等待的事件】设置要监控的事件类型。使用英文半角逗号连接多个类型，例如：created,deleted。

支持的事件类型：

• created 文件或文件夹被创建了。
• deleted 文件或文件夹被删除了。
• changed 文件或文件夹发生了变更。
• renamed 文件或文件夹被重命名了。

【等待秒数】最长等待时间，0表示永久等待。

持续监控文件夹，事件发生后调用子程序进行处理​

【操作类型】选择“持续监控”。

持续监控，在事件发生后调用设定的子程序。

注意：动作将停在此步骤，后续步骤不会被运行。请设定好停止动作的快捷键以方便在必要的时候快速停止动作。

参考动作：文件监控示例

文件系统监控

监控文件创建/变更/删除等事件。

重置

常规

操作类型

持续监控（事件发生后调用子程序）

时间数据来源

文件夹路径

path

要监控的文件夹路径

文件筛选

*.*

筛选要监控的文件。可指定文件名（如foo.txt），或使用通配符（如*.txt）

通知筛选

 

可选，可选值请参考文档。留空表示默认设置(LastWrite,FileName,DirectoryName)。

包含子文件夹

[创建] 处理子程序

OnCreated

文件或文件创建时调用的子程序

[变更] 处理子程序

OnChanged

文件或文件夹变更时调用的子程序

[删除] 处理子程序

OnDeleted

文件或文件被删除时调用的子程序

[重命名] 处理子程序

OnRenamed

文件或文件重命名时调用的子程序

输出到变量

是否成功

isSuccess

操作是否成功

其他参数 (2)

停用此步骤

运行后延迟0保存(S)取消

【文件夹路径】请参考上面章节的说明。

【包含子文件夹】请参考上面章节的说明。

【文件筛选】请参考上面章节的说明。

【通知筛选】请参考上面章节的说明。

【[创建] 处理子程序】设定文件或文件夹被创建时调用的子程序。

【[变更 处理子程序】设定文件或文件夹有变化时调用的子程序。

【[删除] 处理子程序】设定文件或文件夹被删除时调用的子程序。

【[重命名] 处理子程序】设定文件或文件夹被重命名时调用的子程序。

设置事件回调子程序​

设置注意事项：

• 需要监控某个事件时，填写该事件的回调子程序名称。
• 不填写表示不需要监控此事件。
• 可以为每个事件设置单独的子程序，也可以使用同一个子程序处理多个事件。

所有事件类型回调子程序的通用参数（作为输入的变量名称）：

• ChangeType 事件类型。可能的值为：Changed,Created,Deleted,Renamed。
• FullPath 发生事件的文件或文件夹完整路径（重命名时 FullPath 为更改后的完整路径）。
• Name 发生事件的文件或文件夹名称（重命名时 Name 为更改后的名称）。

重命名事件会传入额外的两个参数：

• OldFullPath 文件或文件夹的原始完整路径。
• OldName 文件或文件夹的原始名称。

其它​

如果需要在自定义的时候停止监控，可以使用这样的实现方法：

1. 再次调用本动作，并且传递一个特定的参数，例如shutdown。

2. 动作启动时判断一下参数，如果是这个特定内容shutdown的话，就停止本动作的其他实例：