PhysicalAddress Classe

  • Referência

Definição

Namespace:
System.Net.NetworkInformation
Assembly:
System.Net.NetworkInformation.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origem:
PhysicalAddress.cs
Origem:
PhysicalAddress.cs
Origem:
PhysicalAddress.cs

Fornece o endereço MAC (Controle de Acesso à Mídia) para uma interface de rede (adaptador).

public ref class PhysicalAddress
public class PhysicalAddress
type PhysicalAddress = class
Public Class PhysicalAddress
Herança
Object
PhysicalAddress

Exemplos

O exemplo de código a seguir exibe os endereços físicos de todas as interfaces no computador 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();
    }
}

Comentários

O endereço MAC, ou endereço físico, é um endereço de hardware que identifica exclusivamente cada nó, como um computador ou impressora, em uma rede.

As instâncias dessa classe são retornadas pelo NetworkInterface.GetPhysicalAddress método .

Construtores

PhysicalAddress(Byte[])

Inicializa uma nova instância da classe PhysicalAddress.

Campos

None

Retorna uma nova instância de PhysicalAddress com um endereço de tamanho zero. Este campo é somente leitura.

Métodos

Equals(Object)

Compara duas instâncias PhysicalAddress.
GetAddressBytes()

Retorna o endereço da instância atual.
GetHashCode()

Retorna o valor de hash de um endereço físico.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
Parse(ReadOnlySpan<Char>)

Analisa o trecho especificado e armazena seu conteúdo como os bytes de endereço do PhysicalAddress retornado por esse método.
Parse(String)

Analisa o String especificado e armazena seu conteúdo como os bytes de endereço do PhysicalAddress retornado por esse método.
ToString()

Retorna a representação String do endereço desta instância.
TryParse(ReadOnlySpan<Char>, PhysicalAddress)

Tenta converter a representação do trecho de um endereço de hardware em uma instância PhysicalAddress. Um valor retornado indica se a conversão foi bem-sucedida.
TryParse(String, PhysicalAddress)

Tenta converter a representação da cadeia de caracteres de um endereço de hardware em uma instância de PhysicalAddress. Um valor retornado indica se a conversão foi bem-sucedida.

Aplica-se a