通过

PhysicalAddress.Parse 方法

定义

命名空间:
System.Net.NetworkInformation
程序集:
netstandard.dll, System.Net.NetworkInformation.dll
程序集:
System.Net.NetworkInformation.dll
程序集:
System.dll
程序集:
netstandard.dll

重载

名称 说明
Parse(ReadOnlySpan<Char>)

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

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

Parse(ReadOnlySpan<Char>)

Source:
PhysicalAddress.cs
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
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 中，字母必须为大写。 可以接受的字符串格式的一些示例如下：

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 中，包含的 f0-e1-d2-c3-b4-a5 地址将无法分析和引发异常。

GetAddressBytes使用该方法从现有PhysicalAddress实例检索地址。

适用于