My.Computer.Network.NetworkAvailabilityChanged-Ereignis

Artikel
08/20/2008

Aktualisiert: November 2007

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

' Usage
Public Sub MyComputerNetwork_NetworkAvailabilityChanged( _
   ByVal sender As Object, _
   ByVal e As Devices.NetworkAvailableEventArgs _
)
End Sub
Sub Handle_NetworkAvailabilityChanged()
   AddHandler My.Computer.Network.NetworkAvailabilityChanged, _
      AddressOf MyComputerNetwork_NetworkAvailabilityChanged
End Sub
' Declaration
Public Event NetworkAvailabilityChanged( _
   ByVal sender As Object, _
   ByVal e As Devices.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.

In einer Windows Forms-Anwendung wird dieses Ereignis im Hauptthread der Anwendung mit den anderen Benutzeroberflächenereignissen ausgelöst. Dadurch kann der Ereignishandler direkt auf die Benutzeroberfläche der Anwendung zugreifen. 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.

Sie können das NetworkAvailabilityChanged-Ereignis nicht mit der Handles-Anweisung behandeln. Sie müssen die AddHandler-Anweisung verwenden.

In Windows Forms-Anwendungen macht das My.Application-Objekt ein NetworkAvailabilityChanged-Ereignis verfügbar, das die gleichen Funktionen wie dieses Ereignis bereitstellt, jedoch mit der Handles-Anweisung behandelt werden kann. Weitere Informationen finden Sie unter My.Application.NetworkAvailabilityChanged-Ereignis.

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 geänderte Verbindung zwischen dem Computer und einem Hub an.

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

Beispiel

In diesem Beispiel wird das My.Computer.Network.NetworkAvailabilityChanged-Ereignis verwendet, um die Benutzeroberfläche eines Formulars oder Steuerelements zu aktualisieren.

Private Sub DisplayAvailability(ByVal available As Boolean)
    Label1.Text = available.ToString
End Sub

Private Sub MyComputerNetwork_NetworkAvailabilityChanged( _
    ByVal sender As Object, _
    ByVal e As Devices.NetworkAvailableEventArgs)

    DisplayAvailability(e.IsNetworkAvailable)
End Sub

Private Sub Handle_NetworkAvailabilityChanged()
    AddHandler My.Computer.Network.NetworkAvailabilityChanged, _
       AddressOf MyComputerNetwork_NetworkAvailabilityChanged
    DisplayAvailability(My.Computer.Network.IsAvailable)
End Sub

Dieser Code muss sich in einem Formular oder Steuerelement befinden, das über ein Label mit dem Namen Label1 verfügt. Sie müssen die Handle_NetworkAvailabilityChanged-Methode aufrufen, um die Bezeichnung zu initialisieren und eine Verknüpfung mit dem Ereignishandler herzustellen.