Application.IsDestinationReachable(String) Method

Reference

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets a value indicating whether a connection can be made to the destination computer using the specified Uniform Resource Locator (URL), universal naming convention (UNC) path, or IP address.

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

Parameters

destination: String

Specifies the location to check for network connectivity as an IP address, UNC path, or URLs.

Returns

Boolean

true if a connection can be made to the specified URL, UNC, or IP address; otherwise, false.

Exceptions

FileNotFoundException

The location of the destination cannot be found.

ArgumentNullException

The parameter passed to this method is a null reference (Nothing in Visual Basic).

ArgumentException

The parameter passed to this method is not valid. For example, it is of the wrong type or format.

Examples

In the following example, clicking the Button control displays whether a connection can be made to the specified 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

Remarks

The value specified for destination must be either a UNC path that includes a server name and a share name, such as @"\\MyServer\MyShare", or a URL that begins with one of the following protocol identifiers: http, https, or file.

Note: To get the same functionality when using the FormControl, use the IsDestinationReachable(String) method of the NetworkState class.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

Applies to

Share via