Metodo My.Computer.Network.Ping

Articolo
09/12/2008

Aggiornamento: novembre 2007

Esegue il ping del server specificato.

' 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

Parametri

hostNameOrAddress
String. URL, nome del computer o numero di IP del server cui inviare il ping. Obbligatorio.
address
Uri. URI del server cui inviare il ping. Obbligatorio.
timeout
Int32. Limite di tempo in millisecondi per contattare la destinazione. Il valore predefinito è 500. Obbligatorio.

Valore restituito

Boolean Indica se l'operazione ha avuto esito positivo.

Eccezioni

Le seguenti condizioni possono causare la generazione di un'eccezione:

Connessione di rete non disponibile (InvalidOperationException).
URL non valido (PingException).

Note

Il metodo Ping non è un metodo sicuro per determinare la disponibilità di un computer remoto; infatti la porta del computer di destinazione a cui è diretto il ping potrebbe essere spenta oppure la richiesta di pint potrebbe essere stata bloccata da un firewall o da un router.

L'indirizzo passato al metodo Ping deve essere risolvibile con DNS e non può essere preceduto da "http://".

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.Network.Ping.

Per	Vedere
Determinare se un computer o un host remoto è disponibile	Procedura: determinare la disponibilità di un computer remoto in Visual Basic

Esempio

In questo esempio viene verificato se il server può ricevere il ping determinando se il metodo Ping restituisce True.

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

Sostituire "198.01.01.01" con l'indirizzo IP, l'URL o il nome del computer del server cui inviare il ping.

In questo esempio viene verificato se il server può ricevere il ping determinando se il metodo Ping ha restituito True e specificando un intervallo di timeout di 1000 millisecondi.

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

Sostituire "www.cohowinery.com" con l'indirizzo IP, l'URL o il nome del computer del server cui inviare il ping.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.Devices

Classe:Network

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione di console	Sì
Libreria di controlli Windows	Sì
Libreria di controlli Web	Sì
Servizio Windows	Sì
Sito Web	Sì

Autorizzazioni

Possono essere necessarie le autorizzazioni seguenti:

Autorizzazione	Descrizione
FileIOPermission	Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.
SecurityPermission	Descrive una serie di autorizzazioni di protezione applicate al codice. Enumerazione associata: ControlPrincipal.
WebPermission	Controlla i diritti per accedere alle risorse internet HTTP. Enumerazione associata: Unrestricted.
SocketPermission	Controlla i diritti per creare o accettare connessioni su un indirizzo di trasporto. Enumerazione associata: Unrestricted.
PerformanceCounterPermission	Controlla l'accesso a un componente del contatore di prestazioni di Windows NT. Enumerazione associata: Unrestricted.
NetworkInformationPermission	Controlla l'accesso alle informazioni di rete e alle statistiche sul traffico per il computer locale. Enumerazione associata: Ping.