Compartir a través de


My.Computer.Network.NetworkAvailabilityChanged (Evento)

Actualización: noviembre 2007

Se produce cuando cambia la disponibilidad en red.

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

Parámetros

  • sender
    Obligatorio. Object que provocó el evento.

  • e
    Obligatorio. Un objeto NetworkAvailableEventArgs que contiene información sobre la disponibilidad de la red.

Comentarios

Una aplicación provoca el evento NetworkAvailabilityChanged cada vez que cambia la disponibilidad de la red. Puede utilizar la propiedad IsNetworkAvailable del parámetro e para obtener el nuevo estado de la conexión de red. Para obtener el estado actual de la conexión de red, utilice My.Computer.Network.IsAvailable (Propiedad).

En una aplicación de Windows Forms, este evento se inicia en el subproceso principal de la aplicación con los demás eventos de interfaz del usuario. De este modo, el controlador de eventos puede obtener acceso directo a la interfaz de usuario de la aplicación. Sin embargo, si la aplicación está ocupada con otro evento de la interfaz de usuario al provocarse este evento, éste no se puede procesar hasta que el otro controlador de eventos finalice o llame al método My.Application.DoEvents (Método).

No puede utilizar la instrucción Handles para controlar el evento NetworkAvailabilityChanged; debe utilizar la instrucción AddHandler.

En las aplicaciones de Windows Forms, el objeto My.Application expone un evento NetworkAvailabilityChanged que proporciona las mismas funciones que este evento, pero se puede controlar con la instrucción Handles. Para obtener más información, vea My.Application.NetworkAvailabilityChanged (Evento).

Nota:

Muchos concentradores de red proporcionan una conexión de red, aun cuando el concentrador esté desconectado de una red mayor. Por tanto, en las conexiones por cable, este evento indica un cambio en la conexión entre el equipo y un concentrador.

Nota:

El evento NetworkAvailabilityChanged no se inicia en aplicaciones que se ejecutan en Windows 95 y Windows 98 ni en aplicaciones que ejecuta un usuario no administrador en Windows 2000. Si la aplicación se ejecuta en estas plataformas, utilice My.Computer.Network.IsAvailable (Propiedad) para comprobar la disponibilidad de la red.

Ejemplo

Este ejemplo utiliza el evento My.Computer.Network.NetworkAvailabilityChanged para actualizar la interfaz de usuario de un formulario o 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

Este código debe estar incluido en un formulario o un control con un objeto Label denominado Label1. Debe llamar al método Handle_NetworkAvailabilityChanged para inicializar la etiqueta y enlazar el controlador de eventos.

Requisitos

Espacio de nombres:Microsoft.VisualBasic.Devices

Clase:Network

**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto

Disponible

Aplicación para Windows

Biblioteca de clases

Aplicación de consola

Biblioteca de controles de Windows

Biblioteca de controles Web

Servicio de Windows

Sitio Web

Permisos

No se requiere ningún permiso.

Vea también

Referencia

My.Computer.Network (Objeto)

My.Application.NetworkAvailabilityChanged (Evento)

Microsoft.VisualBasic.Devices.NetworkAvailableEventArgs