PhysicalAddress.Parse Méthode

Définition

Espace de noms:

System.Net.NetworkInformation

Assemblys:

netstandard.dll, System.Net.NetworkInformation.dll

Surcharges

Nom	Description
Parse(ReadOnlySpan<Char>)	Analyse l’étendue spécifiée et stocke son contenu en tant qu’octets d’adresse du PhysicalAddress retourné par cette méthode.
Parse(String)	Analyse le contenu spécifié String et stocke son contenu en tant qu’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 en tant qu’octets d’adresse du 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 matérielle illégale ou contient une chaîne au format incorrect.

Exemples

L’exemple de code suivant crée une 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 contenir que des chiffres et des 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’une instance existante PhysicalAddress .

Parse(String)

Source:

PhysicalAddress.cs

Analyse le contenu spécifié String et stocke son contenu en tant qu’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

Contenant String 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 matérielle illégale ou contient une chaîne au format incorrect.

Exemples

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

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 contenir que des chiffres et des lettres sous forme de chiffres hexadécimaux. Dans .NET Framework, les lettres doivent être 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, une adresse qui contient f0-e1-d2-c3-b4-a5 ne peut pas analyser et lever une exception.

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