My.Computer.Network.NetworkAvailabilityChanged, événement

Article
08/21/2008

Mise à jour : novembre 2007

Se produit lorsque la disponibilité du réseau change.

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

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 chaque fois que 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.

Dans une application Windows Forms, cet événement est déclenché sur le thread principal de l'application avec les autres événements de l'interface utilisateur. Ainsi, le gestionnaire d'événements peut directement accéder à l'interface utilisateur de l'application. Toutefois, si l'application est occupée par la gestion d'un autre événement de l'interface utilisateur lorsque cet événement est déclenché, ce dernier ne pourra pas être traité tant que l'autre gestionnaire d'événements n'a pas terminé ou appelé la méthode My.Application.DoEvents.

Vous ne pouvez pas utiliser l'instruction Handles pour gérer l'événement NetworkAvailabilityChanged ; vous devez utiliser l'instruction AddHandler.

Dans les applications Windows Forms, l'objet My.Application expose un événement NetworkAvailabilityChanged qui fournit les mêmes fonctionnalités que cet événement, mais vous pouvez le gérer avec l'instruction Handles. Pour plus d'informations, consultez My.Application.NetworkAvailabilityChanged, événement.

Remarque :
De nombreux concentrateurs réseau fournissent une connexion réseau, même si le concentrateur est déconnecté d'un réseau de plus grande taille. Par conséquent, pour les connexions câblées, cet événement indique une 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 sur Windows 98 ni par les applications exécutées sur Windows 2000 par un utilisateur qui n'est pas administrateur. Si votre application peut s'exécuter sur ces plates-formes, utilisez la propriété My.Computer.Network.IsAvailable pour vérifier la disponibilité du réseau.

Exemple

Cet exemple utilise l'événement My.Computer.Network.NetworkAvailabilityChanged pour mettre à jour l'interface utilisateur d'un formulaire ou d'un contrôle.

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

Ce code doit figurer dans un formulaire ou dans un contrôle dont l'Label est nommée Label1. Vous devez appeler la méthode Handle_NetworkAvailabilityChanged pour initialiser l'étiquette et raccorder le gestionnaire d'événements.

Configuration requise

Espace de noms :Microsoft.VisualBasic.Devices

Classe :Network

**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	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Oui
Service Windows	Oui
Site Web	Oui

Autorisations

Aucune autorisation n'est requise.

Voir aussi

Référence

My.Computer.Network, objet

My.Application.NetworkAvailabilityChanged, événement

Microsoft.VisualBasic.Devices.NetworkAvailableEventArgs

Partager via