Evento My.Application.NetworkAvailabilityChanged

Artigo
08/25/2010

Ocorre quando a disponibilidade de rede muda.

' 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
Obrigatório.O Object o que elevou o evento.
e
Obrigatório.Um objeto NetworkAvailableEventArgs que contém informações sobre a disponibilidade da rede.

Comentários

Um aplicativo gera o evento NetworkAvailabilityChanged sempre que muda a disponibilidade da rede.Você pode use a propriedade IsNetworkAvailable do parâmetro e para obter o novo estado da conexão de rede.Para obter o estado atual do conexão de rede, use o Propriedade My.Computer.Network.IsAvailable.

Este evento é gerado no segmento principal do aplicativo com os outros eventos da interface do usuário.Isso permite que o manipulador de eventos acesse diretamente a interface do usuário do aplicativo.No entanto, se o aplicativo estiver ocupado tratando outro evento da interface do usuário quando esse evento é gerado, esse evento não pode ser processado até que o outro manipulador de eventos termine ou chame Método My.Application.DoEvents.

O Evento My.Computer.rede.NetworkAvailabilityChanged fornece a mesma funcionalidade que este evento mas está disponível para todos os tipos de aplicativos.

O código para o manipulador NetworkAvailabilityChanged de eventos é armazenado no arquivo ApplicationEvents.vb, que está oculta por padrão.

Para acessar a janela Editor de Códigos para eventos de aplicativo

Tenha um projeto selecionado no Solution Explorer. Clique Propriedades no meni Projeto.
Clique na guia Application.
Clique no botão View Application Events para abrir o Editor de Código.

Para obter mais informações, consulte Como: Manipular eventos de aplicativo (Visual Basic).

Observação:
Muitos hubs de rede fornecerão uma conexão de rede mesmo se o hub for desconectado de uma rede maior.Consequentemente, para conexões cabeadas, esse evento indica alteração na conexão entre o computador e um hub.

Observação:
O NetworkAvailabilityChanged evento não é gerado por aplicativos quando executados no Windows 95 e Windows 98, ou quando executados por um usuário não administrador no Windows 2000. Se seu aplicativo pode ser executado nessas plataformas, use o Propriedade My.Computer.Network.IsAvailable Para verificar a disponibilidade da rede.

Exemplo

Este exemplo chama o método SetConnectionStatus da classe padrão Form1 quando a disponibilidade da rede muda.

Você deve inserir o código na janela Editor de Códigos para eventos do aplicativo.Para acessar essa janela, siga as instruções da seção Comentários deste tópico.

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

Compilando o código

O projeto deve ter um formulário denominado Form1.Ele deve ter um método chamado SetConnectionStatus que utiliza um parâmetro Boolean.

Requisitos

Namespace:Microsoft.VisualBasic.ApplicationServices

Classe:WindowsFormsApplicationBase

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

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Não
Aplicativo de Console	Não
Biblioteca de Controle do Windows	Não
Biblioteca de Controle da Web	Não
Serviço do Windows	Não
Site	Não