PhysicalAddress.Parse Метод

Определение

Пространство имен:

System.Net.NetworkInformation

Сборка:

System.Net.NetworkInformation.dll

Перегрузки

Parse(ReadOnlySpan<Char>)	Анализирует заданный диапазон и сохраняет его содержимое в виде байтов адреса экземпляра PhysicalAddress, возвращаемого этим методом.
Parse(String)	Анализирует заданную строку String и сохраняет ее содержимое в виде байтов адреса экземпляра PhysicalAddress, возвращаемого этим методом.

Parse(ReadOnlySpan<Char>)

Исходный код:

PhysicalAddress.cs

Анализирует заданный диапазон и сохраняет его содержимое в виде байтов адреса экземпляра 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

Параметры

address

ReadOnlySpan<Char>

Диапазон, содержащий адрес, который будет использоваться для инициализации экземпляра PhysicalAddress, возвращаемого этим методом.

Возвращаемое значение

PhysicalAddress

Экземпляр PhysicalAddress с заданным адресом.

Исключения

FormatException

address содержит недопустимый аппаратный адрес или строку в неверном формате.

Примеры

В следующем примере кода создается экземпляр путем PhysicalAddress вызова Parse метода .

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

    return newAddress;
}

Комментарии

Параметр address должен содержать строку, которая может состоять только из цифр и букв в виде шестнадцатеричных цифр. Ниже приведены некоторые примеры допустимых форматов строк.

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

Используйте метод , GetAddressBytes чтобы получить адрес из существующего PhysicalAddress экземпляра.

Parse(String)

Исходный код:

PhysicalAddress.cs

Анализирует заданную строку String и сохраняет ее содержимое в виде байтов адреса экземпляра 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

Параметры

address

String

Строка String, содержащая адрес, будет использоваться для инициализации экземпляра PhysicalAddress, возвращаемого этим методом.

Возвращаемое значение

PhysicalAddress

Экземпляр PhysicalAddress с заданным адресом.

Исключения

FormatException

address содержит недопустимый аппаратный адрес или строку в неверном формате.

Примеры

В следующем примере кода создается экземпляр путем PhysicalAddress вызова Parse метода .

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

Комментарии

Параметр address должен содержать строку, которая может состоять только из цифр и букв в виде шестнадцатеричных цифр. В платформа .NET Framework и .NET Core 3.1 и более ранних версиях буквы должны быть прописными. Ниже приведены некоторые примеры допустимых форматов строк.

001122334455

00-11-22-33-44-55

0011.2233.4455 (Только для .NET 5 и более поздних версий)

00:11:22:33:44:55 (Только для .NET 5 и более поздних версий)

F0-E1-D2-C3-B4-A5

f0-e1-d2-c3-b4-a5 (Только для .NET 5 и более поздних версий)

В платформа .NET Framework и .NET Core 3.1 и более ранних f0-e1-d2-c3-b4-a5 версий адрес, содержащий , не сможет проанализировать и вызвать исключение.

Используйте метод , GetAddressBytes чтобы получить адрес из существующего PhysicalAddress экземпляра.