PhysicalAddress Classe

Définition

Espace de noms:

System.Net.NetworkInformation

Assembly:

System.Net.NetworkInformation.dll

Source:

PhysicalAddress.cs

Fournit l'adresse MAC (Media Access Control) d'une interface réseau (carte réseau).

public ref class PhysicalAddress

public class PhysicalAddress

type PhysicalAddress = class

Public Class PhysicalAddress

Héritage

Object

PhysicalAddress

Exemples

L’exemple de code suivant affiche les adresses physiques de toutes les interfaces sur l’ordinateur local.

void ShowNetworkInterfaces()
{
   IPGlobalProperties^ computerProperties = IPGlobalProperties::GetIPGlobalProperties();
   array<NetworkInterface^>^nics = NetworkInterface::GetAllNetworkInterfaces();
   Console::WriteLine( L"Interface information for {0}.{1}     ", computerProperties->HostName, computerProperties->DomainName );
   if ( nics == nullptr || nics->Length < 1 )
   {
      Console::WriteLine( L"  No network interfaces found." );
      return;
   }

   Console::WriteLine( L"  Number of interfaces .................... : {0}", (nics->Length).ToString() );
   IEnumerator^ myEnum1 = nics->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      NetworkInterface^ adapter = safe_cast<NetworkInterface^>(myEnum1->Current);
      IPInterfaceProperties^ properties = adapter->GetIPProperties();
      Console::WriteLine();
      Console::WriteLine( adapter->Description );
      Console::WriteLine( String::Empty->PadLeft( adapter->Description->Length, '=' ) );
      Console::WriteLine( L"  Interface type .......................... : {0}", adapter->NetworkInterfaceType );
      Console::Write( L"  Physical address ........................ : " );
      PhysicalAddress^ address = adapter->GetPhysicalAddress();
      array<Byte>^bytes = address->GetAddressBytes();
      for ( int i = 0; i < bytes->Length; i++ )
      {
         
         // Display the physical address in hexadecimal.
         Console::Write( L"{0}", bytes[ i ].ToString( L"X2" ) );
         
         // Insert a hyphen after each byte, unless we are at the end of the 
         // address.
         if ( i != bytes->Length - 1 )
         {
            Console::Write( L"-" );
         }

      }
      Console::WriteLine();
   }
}

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(); //  .GetIPInterfaceProperties();
        Console.WriteLine();
        Console.WriteLine(adapter.Description);
        Console.WriteLine(String.Empty.PadLeft(adapter.Description.Length, '='));
        Console.WriteLine("  Interface type .......................... : {0}", adapter.NetworkInterfaceType);
        Console.Write("  Physical address ........................ : ");
        PhysicalAddress address = adapter.GetPhysicalAddress();
        byte[] bytes = address.GetAddressBytes();
        for (int i = 0; i < bytes.Length; i++)
        {
            // Display the physical address in hexadecimal.
            Console.Write("{0}", bytes[i].ToString("X2"));
            // Insert a hyphen after each byte, unless we're at the end of the address.
            if (i != bytes.Length - 1)
            {
                Console.Write("-");
            }
        }
        Console.WriteLine();
    }
}

Remarques

L’adresse MAC, ou adresse physique, est une adresse matérielle qui identifie de manière unique chaque nœud, tel qu’un ordinateur ou une imprimante, sur un réseau.

Les instances de cette classe sont retournées par la NetworkInterface.GetPhysicalAddress méthode .

Constructeurs

PhysicalAddress(Byte[])

Initialise une nouvelle instance de la classe PhysicalAddress.

Champs

None	Retourne une nouvelle instance PhysicalAddress avec une adresse de longueur zéro. Ce champ est en lecture seule.

Méthodes

Equals(Object)	Compare deux instances de PhysicalAddress.
GetAddressBytes()	Retourne l'adresse de l'instance en cours.
GetHashCode()	Retourne la valeur de hachage d'une adresse physique.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Parse(ReadOnlySpan<Char>)	Analyse l’étendue spécifiée et stocke son contenu comme octets d'adresse de la PhysicalAddress retourné par cette méthode.
Parse(String)	Analyse le String spécifié et stocke son contenu comme octets d'adresse du PhysicalAddress retourné par cette méthode.
ToString()	Retourne la représentation String de l'adresse de cette instance.
TryParse(ReadOnlySpan<Char>, PhysicalAddress)	Tente de convertir la représentation d’étendue d’une adresse matérielle en instance PhysicalAddress . Une valeur de retour indique si la conversion a réussi.
TryParse(String, PhysicalAddress)	Tente de convertir la représentation de chaîne d’une adresse matérielle en instance PhysicalAddress. Une valeur de retour indique si la conversion a réussi.