文件通知示例
更新:2007 年 11 月
此示例使用 FileSystemWatcher 类对创建、删除、修改或重命名文件的情况作出响应。
获取示例及其安装说明
执行下列一项或多项操作:
在“帮助”菜单上,单击“示例”。
自述文件将显示有关示例的信息。
访问 Visual Studio 2008 示例网站。该网站提供了最新版本的示例。
在安装了 Visual Studio 的计算机上查找示例。默认情况下,示例和自述文件安装在驱动器号:\Program Files\Microsoft Visual Studio 9.0\Samples\lcid 中。对于 Visual Studio 的速成版,所有示例都可联机找到。
有关更多信息,请参见定位示例文件。
安全说明: |
---|
此示例代码用于阐释概念,因此仅显示与此概念相关的代码。该代码可能不符合特定环境的安全要求,因此不应原样搬用所显示的代码。我们建议您添加安全性代码和错误处理代码,以使项目更加安全可靠。Microsoft“按原样”提供此示例代码,不提供任何保证。 |
运行此示例
按 F5。
使用右边的控件更改被监视的文件。
使用“Windows 资源管理器”更改所监视的文件。以何种方式实现文件更改没有任何差别。
演示
使用该示例窗体可以设置 FileSystemWatcher 类的属性。这包括:
Path 由对象“监视”的文件系统路径。
Filter 要监视的文件类型。默认值为 *.*。
NotifyFilter 要监视的更改类型。此属性可以是 0 或者来自 System.IO.NotifyFilters 枚举的组合在一起的更多值。默认情况下,FileSystemWatcher 检测 FileName、DirectoryName 和 LastWrite 更改。
IncludeSubdirectories 指示监视是否应包含选定路径下的目录。
EnableRaisingEvents 如果为 true,对象将监视文件系统变化,并在发生变化时引发事件。本质上,它就是“on/off 开关”。在此演示中,通过一个显示为切换按钮的 CheckBox 控件来控制此属性。
窗体上的控件使您可以通过创建、删除、重命名和修改文件来生成事件。该窗体的组件栏包括一个 FileSystemWatcher 组件,该组件位于“工具箱”的“组件”选项卡上。通过使用组件,可以使在设计时在“属性”窗口中设置属性变得很简单。
窗体上的“创建”、“重命名”、“修改”和“删除示例文件”按钮用于生成 FileSystemWatcher 事件。这些按钮在选定的文件夹中创建临时文件。操作完成后,使用“删除所有示例文件”按钮可清除所有剩余的示例文件。此示例中处理五个 FileSystemWatcher 事件:
Created、Changed 和 Deleted 这三个事件都由相同的事件处理程序 HandleChangedCreatedDeleted 处理。窗体上显示了事件的详细信息。
Renamed 显示了旧名称和新名称。
Error 显示了异常消息。