My.Application.NetworkAvailabilityChanged-Ereignis

Artikel
08/20/2008

Aktualisiert: November 2007

Tritt ein, wenn sich die Verfügbarkeit des Netzwerks ändert.

' 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 _
)

Parameter

sender
Erforderlich. Das Object, das das Ereignis ausgelöst hat.
e
Erforderlich. Ein NetworkAvailableEventArgs-Objekt, das Informationen über die Verfügbarkeit des Netzwerks enthält.

Hinweise

Eine Anwendung löst immer das NetworkAvailabilityChanged-Ereignis aus, wenn sich die Verfügbarkeit des Netzwerks ändert. Mit der IsNetworkAvailable-Eigenschaft des e-Parameters können Sie den neuen Zustand der Netzwerkverbindung abrufen. Um den aktuellen Zustand der Netzwerkverbindung abzurufen, verwenden Sie die My.Computer.Network.IsAvailable-Eigenschaft.

Dieses Ereignis wird im Hauptthread der Anwendung mit den anderen Benutzeroberflächenereignissen ausgelöst. Dies ermöglicht es dem Ereignishandler, auf die Benutzeroberfläche der Anwendung direkt zuzugreifen. Wenn die Anwendung beim Auslösen dieses Ereignisses gerade ein anderes Benutzeroberflächenereignis behandelt, kann das Ereignis jedoch erst verarbeitet werden, wenn der andere Ereignishandler beendet wurde oder die My.Application.DoEvents-Methode aufruft.

Das My.Computer.Network.NetworkAvailabilityChanged-Ereignis stellt die gleiche Funktionalität wie dieses Ereignis bereit, ist jedoch für alle Anwendungstypen verfügbar.

Der Code für den NetworkAvailabilityChanged-Ereignishandler wird in der Datei ApplicationEvents.vb gespeichert, die standardmäßig ausgeblendet ist.

So öffnen Sie das Code-Editor-Fenster für Anwendungsereignisse

Wählen Sie im Projektmappen-Explorer ein Projekt aus. Klicken Sie im Menü Projekt auf Eigenschaften.
Klicken Sie auf die Registerkarte Anwendung.
Klicken Sie auf die Schaltfläche Anwendungsereignisse anzeigen, um den Code-Editor zu öffnen.

Weitere Informationen finden Sie unter Gewusst wie: Behandeln von Anwendungsereignissen (Visual Basic).

Hinweis:
Viele Netzwerkhubs stellen eine Netzwerkverbindung bereit, auch wenn der Hub nicht mit einem größeren Netzwerk verbunden ist. Daher gibt dieses Ereignis für drahtgebundene Verbindungen eine Änderung der Verbindung zwischen dem Computer und einem Hub an.

Hinweis:
Das NetworkAvailabilityChanged-Ereignis wird von Anwendungen nicht ausgelöst, wenn diese unter Windows 95 oder Windows 98 ausgeführt werden oder wenn sie unter Windows 2000 nicht von einem Administrator ausgeführt werden. Wenn die Anwendung möglicherweise auf einer dieser Plattformen ausgeführt wird, verwenden Sie die My.Computer.Network.IsAvailable-Eigenschaft, um die Netzwerkverfügbarkeit zu überprüfen.

Das NetworkAvailabilityChanged-Ereignis wird von Anwendungen nicht ausgelöst, wenn diese unter Windows 95 oder Windows 98 ausgeführt werden oder wenn sie unter Windows 2000 nicht von einem Administrator ausgeführt werden. Wenn die Anwendung möglicherweise auf einer dieser Plattformen ausgeführt wird, verwenden Sie die My.Computer.Network.IsAvailable-Eigenschaft, um die Netzwerkverfügbarkeit zu überprüfen.

Beispiel

In diesem Beispiel wird die SetConnectionStatus-Methode der Form1-Standardklasse aufgerufen, wenn sich die Netzwerkverfügbarkeit ändert.

Sie müssen den Code im Code-Editor-Fenster für Anwendungsereignisse eingeben. Um dieses Fenster zu öffnen, befolgen Sie die Anweisungen im Abschnitt Hinweise dieses Themas.

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

Kompilieren des Codes

Das Projekt muss das Formular Form1 aufweisen. Es muss über die Methode SetConnectionStatus verfügen, die einen Boolean-Parameter akzeptiert.

Anforderungen

Namespace: Microsoft.VisualBasic.ApplicationServices

Klasse: WindowsFormsApplicationBase

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

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Nein
Konsolenanwendung	Nein
Windows-Steuerelementbibliothek	Nein
Web-Steuerelementbibliothek	Nein
Windows-Dienst	Nein
Website	Nein