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實例擷取位址。