Application.IsDestinationReachable(String) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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.

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

Paramètres

destination: 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.

Retours

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

FileNotFoundException

L'emplacement de la destination est introuvable.

ArgumentNullException

Le paramètre passé à cette méthode est une référence null (Nothing en Visual Basic).

ArgumentException

Le paramètre passé à cette méthode n'est pas valide. Par exemple, le type ou le format est incorrect.

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(
      "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

Remarques

La valeur spécifiée pour destination doit être un chemin UNC qui inclut un nom de serveur et un nom de partage, tel que @"\\MyServer\MyShare », ou une URL commençant par l’un des identificateurs de protocole suivants : http, https ou fichier.

Remarque : pour obtenir les mêmes fonctionnalités lors de l’utilisation de FormControl, utilisez la IsDestinationReachable(String) méthode de la NetworkState classe .

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.

S’applique à

Partager via