My.Computer.Network.Ping, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Exécute une commande ping sur le serveur spécifié.

' Usage
Dim value As Boolean = My.Computer.Network.Ping(hostNameOrAddress)
Dim value As Boolean = My.Computer.Network.Ping(address)
Dim value As Boolean = My.Computer.Network.Ping(hostNameOrAddress ,timeout)
Dim value As Boolean = My.Computer.Network.Ping(address ,timeout)
' Declaration
Public Function Ping( _
   ByVal hostNameOrAddress As String _
) As Boolean
' -or-
Public Function Ping( _
   ByVal address As System.Uri _
) As Boolean
' -or-
Public Function Ping( _
   ByVal hostNameOrAddress As String, _
   ByVal timeout As Integer _
) As Boolean
' -or-
Public Function Ping( _
   ByVal address As System.Uri, _
   ByVal timeout As Integer _
) As Boolean

Paramètres

hostNameOrAddress
String. URL, nom d'ordinateur ou numéro IP du serveur sur lequel exécuter une commande ping. Obligatoire.
address
Uri. URI du serveur sur lequel exécuter une commande ping. Obligatoire.
timeout
Int32. Seuil horaire en millisecondes pour contacter la destination. La valeur par défaut est 500. Obligatoire.

Valeur de retour

Boolean qui indique si l'opération a réussi.

Exceptions

Les conditions ci-dessous peuvent lever une exception :

Aucune connexion réseau n'est disponible (InvalidOperationException).
L'URL n'est pas valide (PingException).

Notes

La méthode Ping ne constitue pas une méthode infaillible pour déterminer la disponibilité d'un ordinateur distant : le port ping sur l'ordinateur cible peut être désactivé ou la demande ping peut être bloquée par un pare-feu ou un routeur.

L'adresse passée à la méthode Ping doit prendre en charge la résolution DNS et ne peut pas être précédée de « http:// ».

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode My.Computer.Network.Ping.

Pour	Consultez
Déterminer si un ordinateur ou un hôte distant est disponible	Comment : déterminer si un ordinateur distant est disponible dans Visual Basic

Exemple

Cet exemple indique si une commande ping peut être exécutée sur le serveur en déterminant si la méthode Ping retourne True.

If My.Computer.Network.Ping("198.01.01.01") Then
   MsgBox("Server pinged successfully.")
Else
   MsgBox("Ping request timed out.")
End If

Remplacez "198.01.01.01" par l'adresse IP, l'URL ou le nom d'ordinateur du serveur sur lequel exécuter une commande ping.

Cet exemple indique si une commande ping peut être exécutée sur le serveur en déterminant si la méthode Ping a retourné True, et spécifie un intervalle de délai d'attente de 1000 millisecondes.

If My.Computer.Network.Ping("www.cohowinery.com",1000) Then
   MsgBox("Server pinged successfully.")
Else
   MsgBox("Ping request timed out.")
End If

Remplacez "www.cohowinery.com" par l'adresse IP, l'URL ou le nom d'ordinateur du serveur sur lequel exécuter une commande ping.

Configuration requise

Espace de noms :Microsoft.VisualBasic.Devices

Classe :Network

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Oui
Service Windows	Oui
Site Web	Oui

Autorisations

Les autorisations suivantes peuvent être nécessaires :

Autorisation	Description
FileIOPermission	Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted.
SecurityPermission	Décrit un jeu d'autorisations de sécurité appliquées au code. Énumération associée : ControlPrincipal.
WebPermission	Contrôle les droits d'accès aux ressources Internet HTTP. Énumération associée : Unrestricted.
SocketPermission	Contrôle les droits de création ou d'acception de connexions sur une adresse de transport. Énumération associée : Unrestricted.
PerformanceCounterPermission	Contrôle l'accès à un composant de compteur de performance Windows NT. Énumération associée : Unrestricted.
NetworkInformationPermission	Contrôle l'accès aux informations réseau et aux statistiques de trafic pour l'ordinateur local. Énumération associée : Ping.