PhysicalAddress.Parse メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 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 、数字と文字のみを 16 進数として構成できる文字列を含む必要があります。 許容される文字列形式の例を次に示します。
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
このメソッドから返される PhysicalAddress インスタンスを初期化するために使用されるアドレスを格納している String。
戻り値
指定したアドレスを持つ PhysicalAddress インスタンス。
例外
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 、数字と文字のみを 16 進数として構成できる文字列を含む必要があります。 .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 のインスタンスからアドレスを取得します。
適用対象
.NET