PhysicalAddress.Parse Methode

Definition

Namespace:

System.Net.NetworkInformation

Assembly:

System.Net.NetworkInformation.dll

Überlädt

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.

Parse(ReadOnlySpan<Char>)

Quelle:

PhysicalAddress.cs

Analysiert die angegebene Spanne und speichert ihren Inhalt als die Adressbytes der von dieser Methode zurückgegebenen PhysicalAddress.

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

Parameter

address

ReadOnlySpan<Char>

Eine Spanne mit der Adresse, die zum Initialisieren der von dieser Methode zurückgegebenen PhysicalAddress-Instanz verwendet wird.

Gibt zurück

PhysicalAddress

Eine PhysicalAddress-Instanz mit der angegebenen Adresse.

Ausnahmen

FormatException

address enthält eine illegale Hardwareadresse oder eine Zeichenfolge im falschen Format.

Beispiele

Im folgenden Codebeispiel wird durch Aufrufen der Parse -Methode eine PhysicalAddress instance erstellt.

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

    return newAddress;
}

Hinweise

Der address Parameter muss eine Zeichenfolge enthalten, die nur aus Zahlen und Buchstaben als Hexadezimalziffern bestehen kann. Einige Beispiele für Zeichenfolgenformate, die zulässig sind, sind wie folgt:

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

Verwenden Sie die GetAddressBytes -Methode, um die Adresse aus einem vorhandenen PhysicalAddress instance abzurufen.

Parse(String)

Quelle:

PhysicalAddress.cs

Analysiert den angegebenen String und speichert seinen Inhalt als die Adressbytes der von dieser Methode zurückgegebenen PhysicalAddress.

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

Parameter

address

String

Ein String mit der Adresse, die zum Initialisieren der von dieser Methode zurückgegebenen PhysicalAddress-Instanz verwendet wird.

Gibt zurück

PhysicalAddress

Eine PhysicalAddress-Instanz mit der angegebenen Adresse.

Ausnahmen

FormatException

address enthält eine illegale Hardwareadresse oder eine Zeichenfolge im falschen Format.

Beispiele

Im folgenden Codebeispiel wird durch Aufrufen der Parse -Methode eine PhysicalAddress instance erstellt.

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;
}

Hinweise

Der address Parameter muss eine Zeichenfolge enthalten, die nur aus Zahlen und Buchstaben als Hexadezimalziffern bestehen kann. In .NET Framework und .NET Core 3.1 und früheren Versionen müssen die Buchstaben groß geschrieben werden. Einige Beispiele für Zeichenfolgenformate, die zulässig sind, sind wie folgt:

001122334455

00-11-22-33-44-55

0011.2233.4455 (Nur.NET 5 und höhere Versionen)

00:11:22:33:44:55 (Nur.NET 5 und höhere Versionen)

F0-E1-D2-C3-B4-A5

f0-e1-d2-c3-b4-a5 (Nur.NET 5 und höhere Versionen)

In .NET Framework und .NET Core 3.1 und früheren Versionen kann eine Adresse, die enthältf0-e1-d2-c3-b4-a5, nicht analysieren und eine Ausnahme auslösen.

Verwenden Sie die GetAddressBytes -Methode, um die Adresse aus einem vorhandenen PhysicalAddress instance abzurufen.