NetworkChange Classe

Définition

Permet aux applications de recevoir une notification quand l'adresse IP (Internet Protocol) d'une interface réseau, également appelée carte réseau, change.Allows applications to receive notification when the Internet Protocol (IP) address of a network interface, also called a network card or adapter, changes.

public ref class NetworkChange sealed
public sealed class NetworkChange
type NetworkChange = class
Public NotInheritable Class NetworkChange
Héritage
NetworkChange

Exemples

L’exemple de code suivant écoute les modifications d’adresse et affiche l’état des interfaces réseau lorsqu’un événement NetworkAddressChanged se produit.The following code example listens for address changes and displays the status of network interfaces when a NetworkAddressChanged event occurs.

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::Net::NetworkInformation;
void AddressChangedCallback( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   array<NetworkInterface^>^adapters = NetworkInterface::GetAllNetworkInterfaces();
   System::Collections::IEnumerator^ myEnum = adapters->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      NetworkInterface^ n = safe_cast<NetworkInterface^>(myEnum->Current);
      Console::WriteLine( "   {0} is {1}", n->Name, n->OperationalStatus );
   }
}

int main()
{
   NetworkChange::NetworkAddressChanged += gcnew NetworkAddressChangedEventHandler( AddressChangedCallback );
   Console::WriteLine( "Listening for address changes. Press any key to exit." );
   Console::ReadLine();
}

using System;
using System.Net;
using System.Net.NetworkInformation;

namespace Examples.Net.AddressChanges
{
    public class NetworkingExample
    {
        public static void Main()
        {
            NetworkChange.NetworkAddressChanged += new 
            NetworkAddressChangedEventHandler(AddressChangedCallback);
            Console.WriteLine("Listening for address changes. Press any key to exit.");
            Console.ReadLine();
        }
        static void AddressChangedCallback(object sender, EventArgs e)
        {
            
            NetworkInterface[] adapters = NetworkInterface.GetAllNetworkInterfaces();
            foreach(NetworkInterface n in adapters)
            {
                Console.WriteLine("   {0} is {1}", n.Name, n.OperationalStatus);
            }
        }
    }
}
Imports System.Net
Imports System.Net.NetworkInformation

Public Class NetworkingExample
    Public Shared Sub Main()
        AddHandler NetworkChange.NetworkAddressChanged, AddressOf AddressChangedCallback
        Console.WriteLine("Listening for address changes. Press any key to exit.")
        Console.ReadLine()
    End Sub
    Private Shared Sub AddressChangedCallback(ByVal sender As Object, ByVal e As EventArgs)

        Dim adapters As NetworkInterface() = NetworkInterface.GetAllNetworkInterfaces()
        Dim n As NetworkInterface
        For Each n In adapters
            Console.WriteLine("   {0} is {1}", n.Name, n.OperationalStatus)
        Next n
    End Sub
End Class

Remarques

La classe NetworkChange fournit une notification de changement d’adresse en déclenchant des événements NetworkAddressChanged.The NetworkChange class provides address change notification by raising NetworkAddressChanged events. Une adresse d’interface peut changer pour de nombreuses raisons, par exemple un câble réseau déconnecté, le déplacement hors limites d’un réseau local sans fil ou une défaillance matérielle.An interface address can change for many reasons, such as a disconnected network cable, moving out of range of a wireless Local Area Network, or hardware failure.

Pour recevoir une notification, vous devez identifier les gestionnaires d’événements de votre application, qui sont une ou plusieurs méthodes qui effectuent vos tâches spécifiques à l’application chaque fois que l’événement est déclenché.To receive notification, you must identify your application's event handlers, which are one or more methods that perform your application-specific tasks each time the event is raised. Pour qu’un objet NetworkChange appelle vos méthodes de gestion des événements lorsqu’un événement NetworkAddressChanged se produit, vous devez associer les méthodes à un délégué NetworkAddressChangedEventHandler et ajouter ce délégué à l’événement.To have a NetworkChange object call your event-handling methods when a NetworkAddressChanged event occurs, you must associate the methods with a NetworkAddressChangedEventHandler delegate, and add this delegate to the event.

Constructeurs

NetworkChange()

Initialise une nouvelle instance de la classe NetworkChange.Initializes a new instance of the NetworkChange class.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
RegisterNetworkChange(NetworkChange)

Enregistre une instance de modification de réseau pour recevoir des événements de modification de réseau.Registers a network change instance to receive network change events.

ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

Événements

NetworkAddressChanged

Se produit lorsque l'adresse IP d'une interface réseau change.Occurs when the IP address of a network interface changes.

NetworkAvailabilityChanged

Se produit lorsque la disponibilité du réseau change.Occurs when the availability of the network changes.

S’applique à