PhysicalAddress.Parse(String) Método

Definição

Espaço de Nomes:
System.Net.NetworkInformation
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Analisa o especificado String e armazena o seu conteúdo como os bytes de endereço dos PhysicalAddress devolvidos por este método.

public:
 static System::Net::NetworkInformation::PhysicalAddress ^ Parse(System::String ^ address);
public static System.Net.NetworkInformation.PhysicalAddress Parse(string address);
static member Parse : string -> System.Net.NetworkInformation.PhysicalAddress
Public Shared Function Parse (address As String) As PhysicalAddress

Parâmetros

address
String

A String contendo o endereço que será usado para inicializar a PhysicalAddress instância devolvida por este método.

Devoluções

PhysicalAddress

Uma PhysicalAddress instância com o endereço especificado.

Exceções

FormatException

address contém um endereço de hardware ilegal ou contém uma cadeia de caracteres no formato incorreto.

Exemplos

O seguinte exemplo de código cria uma PhysicalAddress instância ao chamar o Parse método.

public static PhysicalAddress? StrictParseAddress(string? address)
{
    PhysicalAddress newAddress = PhysicalAddress.Parse(address);
    if (PhysicalAddress.None.Equals(newAddress))
        return null;

    return newAddress;
}

Observações

O address parâmetro deve conter uma cadeia que só pode consistir em números e letras como dígitos hexadecimais. No .NET Framework, as letras devem estar em maiúsculas. Alguns exemplos de formatos de string aceitáveis são os seguintes:

001122334455

00-11-22-33-44-55

0011.2233.4455 (apenas versões .NET 5 e posteriores)

00:11:22:33:44:55 (apenas versões .NET 5 e posteriores)

F0-E1-D2-C3-B4-A5

f0-e1-d2-c3-b4-a5 (apenas versões .NET 5 e posteriores)

No .NET Framework, um endereço que contenha f0-e1-d2-c3-b4-a5 falhará em analisar e lançar uma exceção.

Use o GetAddressBytes método para recuperar o endereço de uma instância existente PhysicalAddress .

Aplica-se a