PhysicalAddress Klasse

Definition

Namespace:

System.Net.NetworkInformation

Assembly:

System.Net.NetworkInformation.dll

Quelle:

PhysicalAddress.cs

Stellt die MAC (Media Access Control)-Adresse für eine Netzwerkschnittstelle (Adapter) bereit.

public ref class PhysicalAddress

public class PhysicalAddress

type PhysicalAddress = class

Public Class PhysicalAddress

Vererbung

Object

PhysicalAddress

Beispiele

Im folgenden Codebeispiel werden die physischen Adressen aller Schnittstellen auf dem lokalen Computer angezeigt.

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();
    }
}

Hinweise

Die MAC-Adresse oder physische Adresse ist eine Hardwareadresse, die jeden Knoten in einem Netzwerk eindeutig identifiziert, z. B. einen Computer oder Drucker.

Instanzen dieser Klasse werden von der NetworkInterface.GetPhysicalAddress -Methode zurückgegeben.

Konstruktoren

PhysicalAddress(Byte[])

Initialisiert eine neue Instanz der PhysicalAddress-Klasse.

Felder

None	Gibt eine neue PhysicalAddress-Instanz mit einer Adresse der Länge 0 (null) zurück. Dieses Feld ist schreibgeschützt.

Methoden

Equals(Object)	Vergleicht zwei PhysicalAddress-Instanzen.
GetAddressBytes()	Gibt die Adresse der aktuellen Instanz zurück.
GetHashCode()	Gibt den Hashwert einer physikalischen Adresse zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Parse(ReadOnlySpan<Char>)	Analysiert die angegebene Spanne und speichert ihren Inhalt als die Adressbytes der von dieser Methode zurückgegebenen PhysicalAddress.
Parse(String)	Analysiert den angegebenen String und speichert seinen Inhalt als die Adressbytes der von dieser Methode zurückgegebenen PhysicalAddress.
ToString()	Gibt die String-Darstellung der Adresse dieser Instanz zurück.
TryParse(ReadOnlySpan<Char>, PhysicalAddress)	Versucht, die Spannendarstellung einer Hardwareadresse in eine PhysicalAddress-Instanz zu konvertieren. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich abgeschlossen wurde.
TryParse(String, PhysicalAddress)	Versucht, die Zeichenfolgendarstellung einer Hardwareadresse in eine PhysicalAddress-Instanz zu konvertieren. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich abgeschlossen wurde.