NetworkChange Classe

Referência

Definição

Namespace:: System.Net.NetworkInformation

Assemblies:: System.dll, System.Net.NetworkInformation.dll

Assemblies:: netstandard.dll, System.Net.NetworkInformation.dll

Assembly:: System.Net.NetworkInformation.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origem:: NetworkAddressChange.cs

Origem:: NetworkAddressChange.cs

Origem:: NetworkAddressChange.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Permite que aplicativos recebam uma notificação quando o endereço IP (Internet Protocol) de uma interface de rede, também chamado de placa ou adaptador de rede, é alterado.

public ref class NetworkChange abstract sealed

public ref class NetworkChange

public ref class NetworkChange sealed

public static class NetworkChange

public class NetworkChange

public sealed class NetworkChange

type NetworkChange = class

Public Class NetworkChange

Public NotInheritable Class NetworkChange

Herança: Object
NetworkChange

Exemplos

O exemplo de código a seguir escuta as alterações de endereço e exibe o status de adaptadores de rede quando ocorre um NetworkAddressChanged evento.

#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

Comentários

A NetworkChange classe fornece notificação de alteração de endereço gerando NetworkAddressChanged eventos. Um endereço de interface pode ser alterado por vários motivos, como um cabo de rede desconectado, sair do alcance de uma Rede local sem fio ou falha de hardware.

Para receber notificação, você deve identificar os manipuladores de eventos do aplicativo, que são um ou mais métodos que executam tarefas específicas do aplicativo sempre que o evento é gerado. Para que um NetworkChange objeto chame seus métodos de manipulação de eventos quando ocorrer um NetworkAddressChanged evento, você deve associar os métodos a um NetworkAddressChangedEventHandler delegado e adicionar esse delegado ao evento.

Construtores

NetworkChange()

Obsoleto.

Inicializa uma nova instância da classe NetworkChange.

Métodos

RegisterNetworkChange(NetworkChange)

Obsoleto.

Registra uma instância de alteração de rede para receber eventos de alteração de rede.

Eventos

NetworkAddressChanged	Ocorre quando o endereço IP de uma interface de rede é alterado.
NetworkAvailabilityChanged	Ocorre quando a disponibilidade da rede muda.

Aplica-se a

Produto	Versões
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0

Compartilhar via