配置表单模板以检测表单的连接状态

如果您正在设计其表单依赖于网络连接来处理或返回数据的表单模板，并且熟悉编写脚本，则可以编写一个脚本，该脚本检测基于表单模板的表单的网络连接 状态。您可以使用此脚本让 Microsoft Office InfoPath 检查新表单是否已连接到网络，以及表单在将查询发送到外部数据源之前是否能连接到外部数据源。本文提供了 JScript 和 VBScript 示例，用于确定基于表单模板的表单是否已连接到网络以及这些表单是否能连接到外部数据源。

• 概述

• JScript 示例

• VBScript 示例

• 在表单模板中使用脚本示例

概述

要确定基于表单模板的表单的网络连接状态，您可以使用 Application 对象的 MachineOnlineState 属性。然后，您可以使用同一 Application 对象的 IsDestinationReachable 方法来确定表单是否能找到外部数据源。MachineOnlineState 属性包含一个表示表单的连接状态的值。此属性可以具有以下值：

确定了用户的计算机已连接到网络后，您可以使用 IsDestinationReachable 方法确定表单是否能与外部数据源通信。此方法采用外部数据源的统一资源定位符 (URL) （统一资源定位符 (URL)：一种地址，指定协议（如 HTTP 或 FTP）以及对象、文档、万维网网页或其他目标在 Internet 或 Intranet 上的位置，例如：http://www.microsoft.com/。） 或统一资源名称 (URN) （统一资源名称 (URN)：按照名称唯一标识 Internet 上可用资源的方案，而不管资源位于什么位置。） 作为参数，并返回以下布尔值之一：

True  表单已在网络上找到外部数据源。

False  表单无法找到外部数据源。外部数据源可能处于脱机状态，或可能在网络上但不可用。

本文中的脚本示例只确定表单是否已连接到网络。在本文中，脚本示例将在用户第一次打开表单时使用。但是，每次想要在执行某项操作之前检查网络连接 时，您也可以使用此脚本。例如，您可以在用户单击表单中的特定按钮时使用此脚本确定是否存在与外部数据源的网络连接。无论何时选择使用此脚本，取决于表单 是否已连接到网络，您还可以添加执行某项操作的脚本。例如，如果计算机处于脱机状态或者无法连接到外部数据源，则可以让 InfoPath 向用户显示一条警告消息，指明外部数据源不可用。您可以自定义警告消息，以告知用户在外部数据源不可用的情况下要怎么做。例如，您可以指示用户稍后尝试填 写表单，或让用户与他们的支持服务人员联系。