PhysicalAddress.Parse 方法

参考

定义

命名空间:: System.Net.NetworkInformation

程序集:: netstandard.dll, System.Net.NetworkInformation.dll

程序集:: System.Net.NetworkInformation.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

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

Parse(ReadOnlySpan<Char>)

Source:: PhysicalAddress.cs

Source:: PhysicalAddress.cs

Source:: PhysicalAddress.cs

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

Source:: PhysicalAddress.cs

Source:: PhysicalAddress.cs

Source:: PhysicalAddress.cs

分析指定的 String 并将其内容存储为由此方法返回的 PhysicalAddress 的地址字节。

public:
 static System::Net::NetworkInformation::PhysicalAddress ^ Parse(System::String ^ address);

public static System.Net.NetworkInformation.PhysicalAddress Parse(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实例。

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

适用于