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 、数字と文字のみを 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)

ソース:

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

このメソッドから返される PhysicalAddress インスタンスを初期化するために使用されるアドレスを格納している String。

戻り値

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 、数字と文字のみを 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 のインスタンスからアドレスを取得します。