Application.IsDestinationReachable(String) 方法

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

获取一个值，指明是否可以使用指定的统一资源定位器 (URL)、通用命名约定 (UNC) 路径或 IP 地址与目标计算机建立连接。

public:
 abstract bool IsDestinationReachable(System::String ^ destination);

public abstract bool IsDestinationReachable (string destination);

abstract member IsDestinationReachable : string -> bool

Public MustOverride Function IsDestinationReachable (destination As String) As Boolean

参数

destination

String

指定要检查网络连接的位置（IP 地址、UNC 路径或 URL）。

返回

Boolean

如果可以与指定的 URL、UNC 或 IP 地址建立连接，则返回 true；否则，将返回 false。

例外

FileNotFoundException

找不到目标位置。

ArgumentNullException

传递给此方法的参数是一个 null 引用， (Visual Basic) 中无任何内容。

ArgumentException

传递给此方法的参数无效。 例如，它的类型或格式有误。

示例

在下面的示例中，单击 Button 控件将显示一个值，指示是否可以与指定的 URL 建立连接。

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   string result = this.Application.IsDestinationReachable(
      "http://www.microsoft.com").ToString();
   MessageBox.Show(result);
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   result As String = Me.Application.IsDestinationReachable( _
      "http://www.microsoft.com").ToString()
   MessageBox.Show(result)
End Sub

注解

为 destination 指定的值必须是包含服务器名称和共享名称的 UNC 路径，例如 @“\\MyServer\MyShare”，或者以以下协议标识符之一开头的 URL：http、https 或文件。

注意：若要在使用 FormControl时获得相同的功能，请使用 IsDestinationReachable(String) 类的 NetworkState 方法。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。