Evento My.Application.NetworkAvailabilityChanged

Articolo
09/12/2008

Aggiornamento: novembre 2007

Si verifica quando cambia la disponibilità della rete.

' Usage
Public Sub Me_NetworkAvailabilityChanged( _
   ByVal sender As Object, _
   ByVal e As NetworkAvailableEventArgs _
) Handles Me.NetworkAvailabilityChanged
End Sub
' Declaration
Public Event NetworkAvailabilityChanged( _
   ByVal sender As Object, _
   ByVal e As NetworkAvailableEventArgs _
)

Parametri

sender
Obbligatorio. Object che ha generato l'evento.
e
Obbligatorio. Oggetto NetworkAvailableEventArgs contenente le informazioni circa la disponibilità della rete.

Note

Un'applicazione genera l'evento NetworkAvailabilityChanged ogni volta che la disponibilità della rete cambia. È possibile utilizzare la proprietà IsNetworkAvailable del parametro e per ottenere il nuovo stato della connessione di rete. Per ottenere lo stato corrente della connessione di rete, utilizzare la Proprietà My.Computer.Network.IsAvailable.

Questo evento viene generato sul thread principale dell'applicazione insieme agli altri eventi di interfaccia utente. Questo consente al gestore eventi di accedere direttamente all'interfaccia dell'applicazione. Se tuttavia l'applicazione è occupata a gestire un altro evento dell'interfaccia utente quando questo viene generato, questo evento non può essere elaborato finché l'altro gestore eventi non finisce o chiama il Metodo My.Application.DoEvents.

L'Evento My.Computer.Network.NetworkAvailabilityChanged fornisce la stessa funzionalità di questo evento, ma è disponibile per tutti i tipi di applicazioni.

Il codice per il gestore eventi NetworkAvailabilityChanged è memorizzato nel file ApplicationEvents.vb, che è nascosto per impostazione predefinita.

Per accedere alla finestra dell'editor del codice per gli eventi applicazioni

Selezionare un progetto in Esplora soluzioni. Scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Applicazione.
Fare clic sul pulsante Visualizza eventi di applicazioni per aprire l'editor di codice.

Per ulteriori informazioni, vedere Procedura: gestire gli eventi di applicazioni (Visual Basic).

Nota:
Molti hub di rete forniscono una connessione anche se l'hub è scollegato da una rete più grande. Di conseguenza, per le connessioni cablate, questo evento indica un cambiamento nella connessione fra il computer e un hub.

Nota:
L'evento NetworkAvailabilityChanged non viene generato dalle applicazioni se eseguite su Windows 95 e Windows 98 o se eseguite su Windows 2000 da un utente senza privilegi di amministratore. Se l'applicazione può essere eseguita su quelle piattaforme, utilizzare la Proprietà My.Computer.Network.IsAvailable per verificare la disponibilità della rete.

Esempio

In questo esempio viene chiamato il metodo SetConnectionStatus della classe Form1 predefinita quando cambia la disponibilità della rete.

È necessario immettere del codice nella finestra dell'editor di codice per gli eventi dell'applicazione. Per accedere a questa finestra, seguire le istruzioni riportate nella sezione Osservazioni di questo argomento.

Private Sub MyApplication_NetworkAvailabilityChanged( _
    ByVal sender As Object, _
    ByVal e As Microsoft.VisualBasic.Devices.NetworkAvailableEventArgs _
) Handles Me.NetworkAvailabilityChanged
    My.Forms.Form1.SetConnectionStatus(e.IsNetworkAvailable)
End Sub

Compilazione del codice

Il progetto dovrebbe avere un form denominato Form1. Dovrebbe inoltre avere un metodo denominato SetConnectionStatus che accetta un parametro Boolean.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.ApplicationServices

Classe:WindowsFormsApplicationBase

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilità per tipo di progetto

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