PhysicalAddress.Parse 方法

定义

命名空间:

System.Net.NetworkInformation

程序集:

System.Net.NetworkInformation.dll

重载

Parse(ReadOnlySpan<Char>)	分析指定的范围，并将其内容存储为由此方法返回的 PhysicalAddress 的地址字节。
Parse(String)	分析指定的 String 并将其内容存储为由此方法返回的 PhysicalAddress 的地址字节。

Parse(ReadOnlySpan<Char>)

Source:

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 包含非法硬件地址或包含格式不正确的字符串。

示例

下面的代码示例通过调用 Parse 方法创建PhysicalAddress实例。

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)

Source:

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 包含非法硬件地址或包含格式不正确的字符串。

示例

下面的代码示例通过调用 Parse 方法创建PhysicalAddress实例。

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实例检索地址。