Application.IsDestinationReachable, méthode
Obtient une valeur qui indique si une connexion peut être établie à l'ordinateur de destination à l'aide de l'URL (Uniform Resource Locator), du chemin d'accès UNC (Universal Naming Convention) ou de l'adresse IP spécifiée.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Function IsDestinationReachable ( _
destination As String _
) As Boolean
'Utilisation
Dim instance As Application
Dim destination As String
Dim returnValue As Boolean
returnValue = instance.IsDestinationReachable(destination)
public abstract bool IsDestinationReachable(
string destination
)
Paramètres
- destination
Type : System.String
Indique l'emplacement dont la connectivité réseau doit être vérifiée, sous la forme d'une adresse IP, d'un chemin d'accès UNC ou d'une URL.
Valeur de retour
Type : System.Boolean
La valeur true est renvoyée si une connexion peut être établie à l'URL, au chemin d'accès UNC ou à l'adresse IP spécifiée. Dans le cas contraire, la valeur false est renvoyée.
Exceptions
| Exception | Condition |
|---|---|
| FileNotFoundException | L'emplacement de la destination est introuvable. |
| ArgumentNullException | Le paramètre passé à cette méthode est une référence NULL (Nothing dans Visual Basic). |
| ArgumentException | Le paramètre passé à cette méthode n'est pas valide. Par exemple, le type ou le format est incorrect. |
Remarques
La valeur de destination spécifiée doit être soit un chemin d'accès UNC qui contient un nom de serveur et un nom de partage, comme @"\\\\MyServer\\MyShare", soit une URL commençant par l'un des identificateurs de protocole suivants : http, https ou protocole de fichier.
Notes
Pour obtenir la même fonctionnalité lorsque vous vous servez du FormControl, utilisez la méthode IsDestinationReachable(String) de la classe NetworkState.
Ce membre est accessible uniquement par les formulaires qui s’exécutent dans le même domaine que le formulaire ouvert ou par les formulaires qui disposent d’autorisations valables pour plusieurs domaines.
Ce type ou ce membre est accessible uniquement à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.
Exemples
Dans l'exemple ci-dessous, le contrôle Button indique si une connexion peut être établie à l'URL spécifiée.
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