PhysicalAddress.Parse Método

Definição

Namespace:

System.Net.NetworkInformation

Assembly:

System.Net.NetworkInformation.dll

Sobrecargas

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.

Parse(ReadOnlySpan<Char>)

Origem:

PhysicalAddress.cs

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

public:
 static System::Net::NetworkInformation::PhysicalAddress ^ Parse(ReadOnlySpan<char> address);

public static System.Net.NetworkInformation.PhysicalAddress Parse (ReadOnlySpan<char> address);

static member Parse : ReadOnlySpan<char> -> System.Net.NetworkInformation.PhysicalAddress

Public Shared Function Parse (address As ReadOnlySpan(Of Char)) As PhysicalAddress

Parâmetros

address

ReadOnlySpan<Char>

Um trecho que contém o endereço que será usado para inicializar a instância de PhysicalAddress retornada por esse método.

Retornos

PhysicalAddress

Uma instância PhysicalAddress 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 exemplo de código a seguir cria uma PhysicalAddress instância chamando o Parse método .

public static PhysicalAddress? StrictParseAddress(ReadOnlySpan<char> address)
{
    PhysicalAddress newAddress = PhysicalAddress.Parse(address);
    if (PhysicalAddress.None.Equals(newAddress))
        return null;

    return newAddress;
}

Comentários

O address parâmetro deve conter uma cadeia de caracteres que só pode consistir em números e letras como dígitos hexadecimais. Alguns exemplos de formatos de cadeia de caracteres aceitáveis são os seguintes:

001122334455

00-11-22-33-44-55

0011.2233.4455

00:11:22:33:44:55

F0-E1-D2-C3-B4-A5

f0-e1-d2-c3-b4-a5

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

Parse(String)

Origem:

PhysicalAddress.cs

Analisa o String especificado e armazena seu conteúdo como os bytes de endereço do PhysicalAddress retornado por esse 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

Um String que contém o endereço que será usado para inicializar a instância PhysicalAddress retornada por esse método.

Retornos

PhysicalAddress

Uma instância PhysicalAddress 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 exemplo de código a seguir cria uma PhysicalAddress instância chamando o Parse método .

PhysicalAddress^ StrictParseAddress( String^ address )
{
   PhysicalAddress^ newAddress = PhysicalAddress::Parse( address );
   if ( PhysicalAddress::None->Equals( newAddress ) )
      return nullptr;

   return newAddress;
}

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

    return newAddress;
}

Comentários

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

001122334455

00-11-22-33-44-55

0011.2233.4455 (somente versões posteriores e do .NET 5)

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

F0-E1-D2-C3-B4-A5

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

No .NET Framework e no .NET Core 3.1 e anteriores, um endereço que contém f0-e1-d2-c3-b4-a5 não analisará e gerará uma exceção.

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