Application.IsDestinationReachable - Méthode

Article
05/11/2015

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 renvoyée

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 (Rien 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.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez uniquement accéder à ce type ou à ce membre à 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

Voir aussi

Référence

Application classe

Application - Membres

Microsoft.Office.InfoPath - Espace de noms

Partager via