Partager via


My.Computer.Network.Ping, méthode

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 :

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.

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Référence

My.Computer.Network, objet

System.Uri

Network.Ping