PhysicalAddress.Parse Método

Definición

Espacio de nombres:

System.Net.NetworkInformation

Ensamblado:

System.Net.NetworkInformation.dll

Sobrecargas

Parse(ReadOnlySpan<Char>)	Analiza el intervalo especificado y almacena su contenido como bytes de la dirección del valor PhysicalAddress devuelto por este método.
Parse(String)	Analiza el objeto String especificado y almacena su contenido como bytes de la dirección del valor PhysicalAddress devuelto por este método.

Parse(ReadOnlySpan<Char>)

Source:

PhysicalAddress.cs

Analiza el intervalo especificado y almacena su contenido como bytes de la dirección del valor PhysicalAddress devuelto por este 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>

Un intervalo que contiene la dirección que se utilizará para inicializar la instancia de PhysicalAddress devuelta por este método.

Devoluciones

PhysicalAddress

Una instancia de PhysicalAddress con la dirección especificada.

Excepciones

FormatException

address contiene una dirección de hardware no válida o contiene una cadena con el formato incorrecto.

Ejemplos

En el ejemplo de código siguiente se crea una instancia mediante una PhysicalAddress llamada al Parse método .

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

    return newAddress;
}

Comentarios

El address parámetro debe contener una cadena que solo puede constar de números y letras como dígitos hexadecimales. Algunos ejemplos de formatos de cadena que son aceptables son los siguientes:

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 el GetAddressBytes método para recuperar la dirección de una instancia existente PhysicalAddress .

Parse(String)

Source:

PhysicalAddress.cs

Analiza el objeto String especificado y almacena su contenido como bytes de la dirección del valor PhysicalAddress devuelto 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

String que contiene la dirección que se utilizará para inicializar la instancia de PhysicalAddress devuelta por este método.

Devoluciones

PhysicalAddress

Una instancia de PhysicalAddress con la dirección especificada.

Excepciones

FormatException

address contiene una dirección de hardware no válida o contiene una cadena con el formato incorrecto.

Ejemplos

En el ejemplo de código siguiente se crea una instancia mediante una PhysicalAddress llamada al 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;
}

Comentarios

El address parámetro debe contener una cadena que solo puede constar de números y letras como dígitos hexadecimales. En .NET Framework y .NET Core 3.1 y versiones anteriores, las letras deben estar mayúsculas. Algunos ejemplos de formatos de cadena que son aceptables son los siguientes:

001122334455

00-11-22-33-44-55

0011.2233.4455 (solo para .NET 5 y versiones posteriores)

00:11:22:33:44:55 (solo para .NET 5 y versiones posteriores)

F0-E1-D2-C3-B4-A5

f0-e1-d2-c3-b4-a5 (solo para .NET 5 y versiones posteriores)

En .NET Framework y .NET Core 3.1 y versiones anteriores, una dirección que contiene f0-e1-d2-c3-b4-a5 no podrá analizar y producir una excepción.

Use el GetAddressBytes método para recuperar la dirección de una instancia existente PhysicalAddress .