My.Application.NetworkAvailabilityChanged, événement

Article
08/21/2008

Mise à jour : novembre 2007

Se produit en cas de modification de la disponibilité du réseau.

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

Paramètres

sender
Obligatoire. Objet Object qui a déclenché l'événement.
e
Obligatoire. Objet NetworkAvailableEventArgs qui contient des informations sur la disponibilité du réseau.

Notes

Une application déclenche l'événement NetworkAvailabilityChanged lorsque la disponibilité du réseau change. Vous pouvez utiliser la propriété IsNetworkAvailable du paramètre e pour obtenir le nouvel état de la connexion réseau. Pour obtenir l'état actuel de la connexion réseau, utilisez la propriété My.Computer.Network.IsAvailable.

Cet événement est déclenché sur le thread principal de l'application avec les autres événements de l'interface utilisateur. Cela permet au gestionnaire d'événements d'accéder directement à l'interface utilisateur de l'application. Toutefois, si l'application est occupée à gérer un autre événement de l'interface utilisateur lorsque cet événement est déclenché, ce dernier ne peut pas être traité tant que l'autre gestionnaire d'événements n'a pas fini ou appelé la méthode My.Application.DoEvents.

L'événement My.Computer.Network.NetworkAvailabilityChanged fournit les mêmes fonctionnalités que cet événement, mais est disponible pour tous les types d'application.

Le code du gestionnaire d'événements NetworkAvailabilityChanged est stocké dans le fichier ApplicationEvents.vb, qui est masqué par défaut.

Pour accéder à la fenêtre de l'éditeur de code pour les événements d'application

Sélectionnez un projet dans l'Explorateur de solutions. Cliquez sur Propriétés dans le menu Projet.
Cliquez sur l'onglet Application.
Cliquez sur le bouton Afficher les événements de l'application pour ouvrir l'éditeur de code.

Pour plus d'informations, consultez Comment : gérer les événements d'application (Visual Basic).

Remarque :
De nombreux concentrateurs de réseau fournissent une connexion réseau même si le concentrateur est déconnecté d'un plus grand réseau. Par conséquent, pour les connexions câblées, cet événement indique la modification de la connexion entre l'ordinateur et un concentrateur.

Remarque :
L'événement NetworkAvailabilityChanged n'est pas déclenché par les applications qui s'exécutent sur Windows 95 et Windows 98, ou qui sont exécutées par une personne autre qu'un administrateur sur Windows 2000. Si votre application s'exécute sur ces plates-formes, utilisez lapropriété My.Computer.Network.IsAvailable pour vérifier la disponibilité du réseau.

Exemple

Cet exemple appelle la méthode SetConnectionStatus de la classe Form1 par défaut lorsque la disponibilité du réseau change.

Vous devez entrer le code dans la fenêtre de l'éditeur de code pour les événements d'application. Pour accéder à cette fenêtre, suivez les instructions contenues dans la section Notes de cette rubrique.

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

Compilation du code

Le projet doit contenir un formulaire nommé Form1. Il doit contenir une méthode nommée SetConnectionStatus qui accepte un paramètre Boolean.

Configuration requise

Espace de noms :Microsoft.VisualBasic.ApplicationServices

Classe :WindowsFormsApplicationBase

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Non
Application console	Non
Bibliothèque de contrôles Windows	Non
Bibliothèque de contrôles Web	Non
Service Windows	Non
Site Web	Non