del método Application.IsDestinationReachable
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.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustOverride Function IsDestinationReachable ( _
destination As String _
) As Boolean
'Uso
Dim instance As Application
Dim destination As String
Dim returnValue As Boolean
returnValue = instance.IsDestinationReachable(destination)
public abstract bool IsDestinationReachable(
string destination
)
Parámetros
destination
Tipo: System.StringEspecifica, en forma de dirección IP, ruta de acceso UNC o direcciones URL, la ubicación cuya conectividad de red se debe comprobar.
Valor devuelto
Tipo: System.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
Excepción | Condición |
---|---|
FileNotFoundException | No se encuentra la ubicación del destino. |
ArgumentNullException | El parámetro pasado a este método es una referencia null (Nothing en Visual Basic). |
ArgumentException | El parámetro pasado a este método no es válido. Por ejemplo, es de un tipo o formato no válido. |
Comentarios
El valor especificado para destination debe ser una ruta de acceso UNC que incluya el nombre de un 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 file.
Nota
Para obtener la misma funcionalidad cuando use el FormControl, use el método IsDestinationReachable(String) de la clase NetworkState.
Ú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.
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(
"https://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( _
"https://www.microsoft.com").ToString()
MessageBox.Show(result)
End Sub