Metodo My.Computer.Network.Ping
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 |
---|---|
Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted. |
|
Descrive una serie di autorizzazioni di protezione applicate al codice. Enumerazione associata: ControlPrincipal. |
|
Controlla i diritti per accedere alle risorse internet HTTP. Enumerazione associata: Unrestricted. |
|
Controlla i diritti per creare o accettare connessioni su un indirizzo di trasporto. Enumerazione associata: Unrestricted. |
|
Controlla l'accesso a un componente del contatore di prestazioni di Windows NT. Enumerazione associata: Unrestricted. |
|
Controlla l'accesso alle informazioni di rete e alle statistiche sul traffico per il computer locale. Enumerazione associata: Ping. |
Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.