My.Application.NetworkAvailabilityChanged (Evento)

Artículo
08/23/2008

Actualización: noviembre 2007

Se produce cuando cambia la disponibilidad de la red.

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

Parámetros

sender
Obligatorio. El 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).

Este evento se inicia en el subproceso principal de la aplicación con los otros eventos de interfaz del usuario. Esto permite al controlador de eventos tener acceso directamente a la interfaz de usuario de la aplicación. Sin embargo, si la aplicación está ocupada controlando otro evento de interfaz de usuario cuando se inicia este evento, éste no se puede procesar hasta que termina el otro controlador de evento o llama al My.Application.DoEvents (Método).

El My.Computer.Network.NetworkAvailabilityChanged (Evento) proporciona la misma funcionalidad que este evento pero está disponible para todos los tipos de aplicación.

El código de este controlador de eventos NetworkAvailabilityChanged se almacena en el archivo ApplicationEvents.vb, que está oculto de manera predeterminada.

Para tener acceso a la ventana del Editor de código para los eventos de aplicación

Tenga seleccionado un proyecto en el Explorador de soluciones. En el menú Proyecto, haga clic en Propiedades.
Haga clic en la ficha Aplicación.
Haga clic en el botón Ver eventos de aplicaciones para abrir el Editor de código.

Para obtener más información, vea Cómo: Controlar eventos de aplicaciones (Visual Basic).

Nota:
Muchos concentradores de red proporcionan una conexión de red aun cuando el concentrador se desconecta de una red mayor. Por consiguiente, para las conexiones cableadas, este evento indica un cambio en la conexión entre el equipo y un concentrador.

Nota:
El evento NetworkAvailabilityChanged no lo producen las aplicaciones cuando se ejecutan en Windows 95 y Windows 98, o cuando las ejecuta en Windows 2000 un usuario que no es administrador. Si su aplicación podría ejecutarse en esas plataformas, utilice la My.Computer.Network.IsAvailable (Propiedad) para comprobar la disponibilidad de la red.

Ejemplo

Este ejemplo llama al método SetConnectionStatus de la clase predeterminada Form1 cuando cambia la disponibilidad de la red.

Debe escribir el código en la ventana del Editor de código para los eventos de aplicaciones. Para tener acceso a esta ventana, siga las instrucciones de la sección Comentarios de este tema.

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

Compilar el código

El proyecto debería tener un formulario denominado Form1. Debe incluir un método denominado SetConnectionStatus que toma un parámetro Boolean.

Requisitos

Espacio de nombres:Microsoft.VisualBasic.ApplicationServices

Clase:WindowsFormsApplicationBase

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

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	No
Aplicación de consola	No
Biblioteca de controles de Windows	No
Biblioteca de controles Web	No
Servicio de Windows	No
Sitio Web	No