PhysicalAddress.Parse 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Parse(ReadOnlySpan<Char>) |
解析指定的區間，並將其內容儲存為此方法回傳的位址位元組 PhysicalAddress 。 |
| Parse(String) |
解析指定的 String 資料，並將其內容儲存為此方法回傳的 PhysicalAddress 位址位元組。 |
Parse(ReadOnlySpan<Char>)
解析指定的區間，並將其內容儲存為此方法回傳的位址位元組 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.PhysicalAddressPublic Shared Function Parse (address As ReadOnlySpan(Of Char)) As PhysicalAddress參數
- address
- ReadOnlySpan<Char>
一個包含用來初始化 PhysicalAddress 此方法回傳實例的位址的區間。
傳回
一個 PhysicalAddress 擁有指定位址的實例。
例外狀況
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)
解析指定的 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.PhysicalAddressPublic Shared Function Parse (address As String) As PhysicalAddress參數
- address
- String
A String 包含將用於初始化此方法回傳實 PhysicalAddress 例的位址。
傳回
一個 PhysicalAddress 擁有指定位址的實例。
例外狀況
address 包含非法硬體位址或包含錯誤格式的字串。
範例
以下程式碼範例透過呼叫該PhysicalAddress方法建立Parse實例。
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 實例中取得地址。
