PhysicalAddress.Parse Méthode

Définition

Espace de noms:

System.Net.NetworkInformation

Assembly:

System.Net.NetworkInformation.dll

Surcharges

Parse(ReadOnlySpan<Char>)	Analyse l’étendue spécifiée et stocke son contenu comme octets d'adresse de la PhysicalAddress retourné par cette méthode.
Parse(String)	Analyse le String spécifié et stocke son contenu comme octets d'adresse du PhysicalAddress retourné par cette méthode.

Parse(ReadOnlySpan<Char>)

Source:

PhysicalAddress.cs

Analyse l’étendue spécifiée et stocke son contenu comme octets d'adresse de la PhysicalAddress retourné par cette méthode.

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

Paramètres

address

ReadOnlySpan<Char>

Étendue contenant l’adresse qui sera utilisée pour initialiser l’instance PhysicalAddress retournée par cette méthode.

Retours

PhysicalAddress

Instance PhysicalAddress avec l'adresse spécifiée.

Exceptions

FormatException

address contient une adresse de matériel illégale ou une chaîne au format incorrect.

Exemples

L’exemple de code suivant crée un PhysicalAddress instance en appelant la Parse méthode .

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

    return newAddress;
}

Remarques

Le address paramètre doit contenir une chaîne qui ne peut être constituée que de chiffres et de lettres sous forme de chiffres hexadécimaux. Voici quelques exemples de formats de chaîne acceptables :

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

Utilisez la GetAddressBytes méthode pour récupérer l’adresse d’un instance existant PhysicalAddress .

Parse(String)

Source:

PhysicalAddress.cs

Analyse le String spécifié et stocke son contenu comme octets d'adresse du PhysicalAddress retourné par cette méthode.

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

Paramètres

address

String

String contenant l'adresse qui sera utilisée pour initialiser l'instance PhysicalAddress retournée par cette méthode.

Retours

PhysicalAddress

Instance PhysicalAddress avec l'adresse spécifiée.

Exceptions

FormatException

address contient une adresse de matériel illégale ou une chaîne au format incorrect.

Exemples

L’exemple de code suivant crée un PhysicalAddress instance en appelant la Parse méthode .

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

Remarques

Le address paramètre doit contenir une chaîne qui ne peut être constituée que de chiffres et de lettres sous forme de chiffres hexadécimaux. Dans .NET Framework et .NET Core 3.1 et versions antérieures, les lettres doivent être en majuscules. Voici quelques exemples de formats de chaîne acceptables :

001122334455

00-11-22-33-44-55

0011.2233.4455 (.NET 5 et versions ultérieures uniquement)

00:11:22:33:44:55 (.NET 5 et versions ultérieures uniquement)

F0-E1-D2-C3-B4-A5

f0-e1-d2-c3-b4-a5 (.NET 5 et versions ultérieures uniquement)

Dans .NET Framework et .NET Core 3.1 et versions antérieures, une adresse qui contient f0-e1-d2-c3-b4-a5 ne parvient pas à analyser et à lever une exception.

Utilisez la GetAddressBytes méthode pour récupérer l’adresse d’un instance existant PhysicalAddress .