Application.IsDestinationReachable(String) Método

Definición

Espacio de nombres:

Microsoft.Office.InfoPath

Ensamblado:

Microsoft.Office.InfoPath.dll

Obtiene un valor que indica si se puede establecer una conexión con el equipo de destino con el Localizador de recursos universal (URL), la ruta de acceso de la Convención de nomenclatura universal (UNC) o la dirección IP especificados.

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

Parámetros

destination

String

Especifica, en forma de dirección IP, ruta de acceso UNC o direcciones URL, la ubicación cuya conectividad de red se debe comprobar.

Devoluciones

Boolean

true si se puede establecer una conexión con la dirección IP, ruta de acceso UNC o dirección URL especificadas; en caso contrario, false.

Excepciones

FileNotFoundException

No se encuentra la ubicación del destino.

ArgumentNullException

El parámetro pasado a este método es una referencia nula (Nothing en Visual Basic).

ArgumentException

El parámetro que se ha pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido.

Ejemplos

En el siguiente ejemplo, si se hace clic en el control Button, se muestra si se puede establecer una conexión con la dirección URL especificada.

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

Comentarios

El valor especificado para destination debe ser una ruta de acceso UNC que incluya un nombre de servidor y un nombre de recurso compartido, como @"\\MyServer\MyShare", o una dirección URL que comience con uno de los siguientes identificadores de protocolo: http, https o archivo.

Nota: Para obtener la misma funcionalidad al usar FormControl, use el IsDestinationReachable(String) método de la NetworkState clase .

Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.

Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.