NetworkInterface Classe

Définition

Espace de noms:
System.Net.NetworkInformation
Assemblys:
System.dll, System.Net.NetworkInformation.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Fournit des informations statistiques et de configuration pour une interface réseau.

public ref class NetworkInterface abstract sealed
public ref class NetworkInterface abstract
public static class NetworkInterface
public abstract class NetworkInterface
type NetworkInterface = class
Public Class NetworkInterface
Public MustInherit Class NetworkInterface
Héritage
Object
NetworkInterface

Exemples

L’exemple de code suivant affiche des informations sur les interfaces.

public static void ShowNetworkInterfaces()
{
    IPGlobalProperties computerProperties = IPGlobalProperties.GetIPGlobalProperties();
    NetworkInterface[] nics = NetworkInterface.GetAllNetworkInterfaces();
    Console.WriteLine("Interface information for {0}.{1}     ",
            computerProperties.HostName, computerProperties.DomainName);
    if (nics == null || nics.Length < 1)
    {
        Console.WriteLine("  No network interfaces found.");
        return;
    }

    Console.WriteLine("  Number of interfaces .................... : {0}", nics.Length);
    foreach (NetworkInterface adapter in nics)
    {
        IPInterfaceProperties properties = adapter.GetIPProperties();
        Console.WriteLine();
        Console.WriteLine(adapter.Description);
        Console.WriteLine(String.Empty.PadLeft(adapter.Description.Length,'='));
        Console.WriteLine("  Interface type .......................... : {0}", adapter.NetworkInterfaceType);
        Console.WriteLine("  Physical Address ........................ : {0}",
                   adapter.GetPhysicalAddress().ToString());
        Console.WriteLine("  Operational status ...................... : {0}",
            adapter.OperationalStatus);
        string versions ="";

        // Create a display string for the supported IP versions.
        if (adapter.Supports(NetworkInterfaceComponent.IPv4))
        {
             versions = "IPv4";
         }
        if (adapter.Supports(NetworkInterfaceComponent.IPv6))
        {
            if (versions.Length > 0)
            {
                versions += " ";
             }
            versions += "IPv6";
        }
        Console.WriteLine("  IP version .............................. : {0}", versions);
        ShowIPAddresses(properties);

        // The following information is not useful for loopback adapters.
        if (adapter.NetworkInterfaceType == NetworkInterfaceType.Loopback)
        {
            continue;
        }
        Console.WriteLine("  DNS suffix .............................. : {0}",
            properties.DnsSuffix);

        string label;
        if (adapter.Supports(NetworkInterfaceComponent.IPv4))
        {
            IPv4InterfaceProperties ipv4 = properties.GetIPv4Properties();
            Console.WriteLine("  MTU...................................... : {0}", ipv4.Mtu);
            if (ipv4.UsesWins)
            {

                IPAddressCollection winsServers = properties.WinsServersAddresses;
                if (winsServers.Count > 0)
                {
                    label = "  WINS Servers ............................ :";
                    ShowIPAddresses(label, winsServers);
                }
            }
        }

        Console.WriteLine("  DNS enabled ............................. : {0}",
            properties.IsDnsEnabled);
        Console.WriteLine("  Dynamically configured DNS .............. : {0}",
            properties.IsDynamicDnsEnabled);
        Console.WriteLine("  Receive Only ............................ : {0}",
            adapter.IsReceiveOnly);
        Console.WriteLine("  Multicast ............................... : {0}",
            adapter.SupportsMulticast);
        ShowInterfaceStatistics(adapter);

        Console.WriteLine();
    }
}

Remarques

Cette classe encapsule les données des interfaces réseau, également appelées cartes, sur l’ordinateur local. Vous ne créez pas d’instances de cette classe ; la GetAllNetworkInterfaces méthode retourne un tableau qui contient une instance de cette classe pour chaque interface réseau sur l’ordinateur local.

Constructeurs

Nom Description
NetworkInterface()

Initialise une nouvelle instance de la classe NetworkInterface.

Propriétés

Nom Description
Description

Obtient la description de l’interface.
Id

Obtient l’identificateur de la carte réseau.
IPv6LoopbackInterfaceIndex

Obtient l’index de l’interface de bouclage IPv6.
IsReceiveOnly

Obtient une Boolean valeur qui indique si l’interface réseau est définie pour recevoir uniquement les paquets de données.
LoopbackInterfaceIndex

Obtient l’index de l’interface de bouclage IPv4.
Name

Obtient le nom de la carte réseau.
NetworkInterfaceType

Obtient le type d’interface.
OperationalStatus

Obtient l’état opérationnel actuel de la connexion réseau.
Speed

Obtient la vitesse de l’interface réseau.
SupportsMulticast

Obtient une Boolean valeur qui indique si l’interface réseau est activée pour recevoir des paquets de multidiffusion.

Méthodes

Nom Description
GetAllNetworkInterfaces()

Retourne des objets qui décrivent les interfaces réseau sur l’ordinateur local.
GetIPProperties()

Retourne un objet qui décrit la configuration de cette interface réseau.
GetIPStatistics()

Obtient les statistiques IP de cette NetworkInterface instance.
GetIPv4Statistics()

Obtient les statistiques IPv4 pour cette NetworkInterface instance.
GetIsNetworkAvailable()

Indique si une connexion réseau est disponible.
GetPhysicalAddress()

Retourne l’adresse media Access Control (MAC) ou physique pour cet adaptateur.
Supports(NetworkInterfaceComponent)

Obtient une Boolean valeur qui indique si l’interface prend en charge le protocole spécifié.

S’applique à