IPEndPoint.Parse メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.Primitives.dll

オーバーロード

Parse(ReadOnlySpan<Char>)	読み取り専用スパンとして表される IP ネットワーク エンドポイント (アドレスとポート) を IPEndPoint インスタンスに変換します。
Parse(String)	文字列として表される IP ネットワーク エンドポイント (アドレスとポート) を IPEndPoint インスタンスに変換します。

注釈

の部分の数 (各部分はピリオドで区切ります) s によって、エンドポイントの IP アドレスの作成方法が決まります。 1 部構成のアドレスは、ネットワーク アドレスに直接格納されます。 クラス A アドレスを指定する場合に便利な 2 部構成のアドレスは、先頭部分を最初のバイトに、末尾の部分をネットワーク アドレスの右端の 3 バイトに配置します。 クラス B アドレスを指定する場合に便利な 3 部構成のアドレスは、最初の部分を最初のバイトに、2 番目の部分を 2 番目のバイトに、最後の部分をネットワーク アドレスの右端の 2 バイトに配置します。 次に例を示します。

パーツの数と例 s	IPEndPoint.Address の IPv4 アドレス	ポート
1 -- "1"	0.0.0.1	0
2 -- "20.2:80"	20.0.0.2	80
2 -- "20.65535:23"	20.0.255.255	23
3 -- "128.1.2:443"	128.1.0.2	443

重要

このメソッドは、 として解析できる有効な値として Int64を受け取り、IPAddress Int64 コンストラクターと同様に、ネットワーク バイト順の IP アドレスの長い値として扱うことに注意してください。 つまり、有効な IP アドレスではないアドレスを表していても、Int64 が正常に解析された場合、このメソッドは true を返します。 たとえば、s が "1" の場合、"1" (または 0.0.0.1) が有効な IP アドレスではなく、このメソッドが false を返すと予想される場合でも、このメソッドは true を返します。 このバグを修正すると、既存のアプリが壊れるので、現在の動作は変更されません。 コードでは、このメソッドのみを使用してドット付き 10 進数形式で IP アドレスを解析することで、この動作を回避できます。

ポート番号を指定するエンドポイントを渡す場合、リテラル IPv6 アドレスは角かっこ [] で囲む必要があります。それ以外の場合は、中かっこは必須ではありません。

Parse(ReadOnlySpan<Char>)

ソース:

IPEndPoint.cs

読み取り専用スパンとして表される IP ネットワーク エンドポイント (アドレスとポート) を IPEndPoint インスタンスに変換します。

public:
 static System::Net::IPEndPoint ^ Parse(ReadOnlySpan<char> s);

public static System.Net.IPEndPoint Parse (ReadOnlySpan<char> s);

static member Parse : ReadOnlySpan<char> -> System.Net.IPEndPoint

Public Shared Function Parse (s As ReadOnlySpan(Of Char)) As IPEndPoint

パラメーター

s

ReadOnlySpan<Char>

IPv4 の場合はドット区切りの 10 進表記またはネットワークのバイト順、IPv6 の場合はコロン区切りの 16 進表記の IP エンドポイントが格納されている読み取り専用スパン。

戻り値

IPEndPoint

IP ネットワーク エンドポイントのオブジェクト表現。

例外

ArgumentNullException

s が nullです。

FormatException

s が有効な IP エンドポイントではありません。

Parse(String)

ソース:

IPEndPoint.cs

文字列として表される IP ネットワーク エンドポイント (アドレスとポート) を IPEndPoint インスタンスに変換します。

public:
 static System::Net::IPEndPoint ^ Parse(System::String ^ s);

public static System.Net.IPEndPoint Parse (string s);

static member Parse : string -> System.Net.IPEndPoint

Public Shared Function Parse (s As String) As IPEndPoint

パラメーター

s

String

IPv4 の場合はドット区切りの 10 進表記またはネットワークのバイト順、IPv6 の場合はコロン区切りの 16 進表記の IP エンドポイントが格納されている文字列。

戻り値

IPEndPoint

IP ネットワーク エンドポイントのオブジェクト表現。

例外

ArgumentNullException

s が nullです。

FormatException

s が有効な IP エンドポイントではありません。