IPEndPoint.TryParse メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.Primitives.dll

オーバーロード

TryParse(ReadOnlySpan<Char>, IPEndPoint)	読み取り専用スパンとして表される IP ネットワーク エンドポイント (アドレスとポート) からその同等の IPEndPoint への変換を試行し、変換に成功したかどうかを示す値を返します。
TryParse(String, IPEndPoint)	文字列として表される 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 アドレスの long 値として扱うことに注意してください。 つまり、有効な IP アドレスではないアドレスを表している場合でも、Int64 が正常に解析された場合、このメソッドは true を返します。 たとえば、s が "1" の場合、"1" (または 0.0.0.1) が有効な IP アドレスではなく、このメソッドが false を返すと予想される場合でも、このメソッドは true を返します。 このバグを修正すると、既存のアプリが中断されるため、現在の動作は変更されません。 コードでは、このメソッドのみを使用してドット 10 進数形式で IP アドレスを解析することで、この動作を回避できます。

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

TryParse(ReadOnlySpan<Char>, IPEndPoint)

ソース:

IPEndPoint.cs

読み取り専用スパンとして表される IP ネットワーク エンドポイント (アドレスとポート) からその同等の IPEndPoint への変換を試行し、変換に成功したかどうかを示す値を返します。

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::Net::IPEndPoint ^ % result);

public static bool TryParse (ReadOnlySpan<char> s, out System.Net.IPEndPoint? result);

static member TryParse : ReadOnlySpan<char> * IPEndPoint -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As IPEndPoint) As Boolean

パラメーター

s

ReadOnlySpan<Char>

検証する IP エンドポイント。

result

IPEndPoint

このメソッドから制御が戻るときの、s の IPEndPoint バージョン。

戻り値

Boolean

s を IP エンドポイントとして解析できる場合は true。それ以外の場合は false。

TryParse(String, IPEndPoint)

ソース:

IPEndPoint.cs

文字列として表される IP ネットワーク エンドポイント (アドレスとポート) からその同等の IPEndPoint への変換を試行し、変換に成功したかどうかを示す値を返します。

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::Net::IPEndPoint ^ % result);

public static bool TryParse (string s, out System.Net.IPEndPoint? result);

static member TryParse : string * IPEndPoint -> bool

Public Shared Function TryParse (s As String, ByRef result As IPEndPoint) As Boolean

パラメーター

s

String

検証する IP エンドポイント。

result

IPEndPoint

このメソッドから制御が戻るときの、s の IPEndPoint バージョン。

戻り値

Boolean

s を IP エンドポイントとして解析できる場合は true。それ以外の場合は false。