PhysicalAddress Klasse

  • Referenz

Definition

Namespace:
System.Net.NetworkInformation
Assembly:
System.Net.NetworkInformation.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Quelle:
PhysicalAddress.cs
Quelle:
PhysicalAddress.cs
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.

Gilt für: