如何：在 Windows 应用程序中提供帮助

更新：2007 年 11 月

使用 HelpProvider 组件，可以将帮助文件中的帮助主题附加到 Windows 窗体的特定控件。帮助文件可以是 HTML、HTMLHelp 1.x 或更高版本的格式。

说明：
显示的对话框和菜单命令可能会与“帮助”中的描述不同，具体取决于您的当前设置或版本。若要更改设置，请在“工具”菜单上选择“导入和导出设置”。有关更多信息，请参见 Visual Studio 设置。

提供帮助

1. 将 HelpProvider 组件从“工具箱”拖到窗体上。

   该组件将位于 Windows 窗体设计器底部的栏中。

2. 在“属性”窗口中，将 HelpNamespace 属性设置为 .chm、.col 或 .htm 帮助文件。

3. 选择窗体上的另一个控件，在“属性”窗口中设置 HelpKeyword 属性。

   这是通过 HelpProvider 组件传递给帮助文件的字符串，用于请求相应的“帮助”主题。

4. 在“属性”窗口中，将 HelpNavigator 属性设置为 HelpNavigator 枚举的值。

   这将确定以何种方式将 HelpKeyword 属性传递给帮助系统。下表显示可能的设置及其说明。

   成员名称	说明
   AssociateIndex	指定在指定 URL 中执行指定主题的索引。
   查找	指定显示指定 URL 的搜索页。
   索引	指定显示指定 URL 的索引。
   KeywordIndex	指定要搜索的关键字和要在指定 URL 中采取的操作。
   TableOfContents	指定显示 HTML 1.0 帮助文件的目录。
   主题	指定显示指定 URL 引用的主题。

在运行时，如果当已设置 HelpKeyword 和 HelpNavigator 属性的控件具有焦点时按 F1 键，将打开与 HelpProvider 组件关联的帮助文件。

目前，HelpNamespace 属性支持下列三种格式的帮助文件：HTMLHelp 1.x、HTMLHelp 2.0 和 HTML。因此，可以将 HelpNamespace 属性设置为 http:// 地址（如网页）。如果此操作已完成，将打开默认浏览器，并显示作为定位点的**“HelpKeyword”**属性中指定的字符串所对应的网页。定位点用于跳转到 HTML 页的特定部分。

安全说明：
一定要先仔细检查从客户端发来的所有信息，再在应用程序中使用这些信息。恶意用户可能会试图发送或注入可执行脚本、SQL 语句或其他代码。显示用户的输入、将其存储在数据库中或使用它之前，请确定它没有包含可能的不安全信息。通常的检查方法是在收到某个用户发来的输入后，使用正则表达式查找关键字，如“SCRIPT”。

还可使用 HelpProvider 组件显示弹出帮助（即使已经将其配置为显示 Windows 窗体上控件的帮助文件）。有关更多信息，请参见 如何：显示弹出帮助。

请参见

任务

如何：显示弹出帮助

概念

使用工具提示的控件帮助

其他资源

在 Windows 窗体中集成用户帮助

Windows 窗体