My.Computer.Network.NetworkAvailabilityChanged Event

Article
11/16/2012

Occurs when the network availability changes.

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

Parameters

sender
Required. The Object that raised the event.
e
Required. A NetworkAvailableEventArgs object that contains information about the availability of the network.

Remarks

An application raises the NetworkAvailabilityChanged event every time the availability of the network changes. You can use the IsNetworkAvailable property of the e parameter to get the new state of the network connection. To get the current state of the network connection, use the My.Computer.Network.IsAvailable Property.

In a Windows Forms application, this event is raised on the application's main thread with the other user-interface events. This allows the event handler to directly access the application's user interface. However, if the application is busy handling another user-interface event when this event is raised, this event cannot be processed until the other event handler finishes or calls the My.Application.DoEvents Method.

You cannot use the Handles statement to handle the NetworkAvailabilityChanged event; you must use the AddHandler statement.

In Windows Forms applications, the My.Application object exposes a NetworkAvailabilityChanged event that provides the same functionality as this event, but you can handle it with the Handles statement. For more information, see My.Application.NetworkAvailabilityChanged Event.

Note

Many network hubs provide a network connection, even if the hub is disconnected from a larger network. Consequently, for wired connections, this event indicates a change in the connection between the computer and a hub.

Note

The NetworkAvailabilityChanged event is not raised by applications that run on Windows 95 and Windows 98 or by applications that are run on Windows 2000 by a non-administrator. If your application might run on those platforms, use the My.Computer.Network.IsAvailable Property to check for network availability.

Example

This example uses the My.Computer.Network.NetworkAvailabilityChanged event to update the user interface of a form or control.

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

This code should to be in a form or control that has a Label named Label1. You must call the Handle_NetworkAvailabilityChanged method to initialize the label and hook up the event handler.

Requirements

Namespace:Microsoft.VisualBasic.Devices

Class:Network

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

Availability by Project Type

Project type	Available
Windows Application	Yes
Class Library	Yes
Console Application	Yes
Windows Control Library	Yes
Web Control Library	Yes
Windows Service	Yes
Web Site	Yes

Permissions

No permissions are required.

Share via