IPEndPoint.Parse 方法

定義

命名空間:

System.Net

組件:

System.Net.Primitives.dll

多載

Parse(ReadOnlySpan<Char>)	將表示為唯讀範圍的 IP 網路端點 (位址和連接埠) 轉換成 IPEndPoint 執行個體。
Parse(String)	將表示為字串的 IP 網路端點 (位址和連接埠) 轉換成 IPEndPoint 執行個體。

備註

中每個部分 (部分的數目會以句點分隔，) s 決定端點 IP 位址的建構方式。 一部分位址會直接儲存在網路位址中。 兩部分位址，方便指定類別 A 位址，會將前置部分放在第一個字節中，而尾端部分則放在網路位址最右邊的三個字節中。 三部分位址，方便指定類別 B 位址、將第一個部分放在第一個字節、第二個字節中，以及最後一個部分放在網路位址最右邊的兩個字節中。 例如：

元件和範例的數目 s	IPEndPoint.Address 的 IPv4 位址	Port
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，然後以網路位元組順序將它 Int64 視為IP位址的長值，類似於IPAddress建構函式執行的方式。 這表示如果成功剖析 Int64，這個方法會傳回 true，即使它代表不是有效 IP 位址的位址也一樣。 例如，如果 s 為 “1”，即使 “1” (或 0.0.0.1) 不是有效的 IP 位址，這個方法仍會傳回 true，而且您可能會預期此方法會傳回 false。 修正此 Bug 會中斷現有的應用程式，因此不會變更目前的行為。 您的程式代碼可以藉由確保它只使用這個方法來剖析以點狀十進位格式的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>

包含 IP 端點的唯讀範圍，IPv4 是使用點分隔四組數字標記法或網路位元組順序，IPv6 是使用冒號分隔十六進位標記法。

傳回

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

包含 IP 端點的字串，IPv4 是使用點分隔四組數字標記法或網路位元組順序，IPv6 是使用冒號分隔十六進位標記法。

傳回

IPEndPoint

IP 網路端點的物件表示。

例外狀況

ArgumentNullException

s 為 null。

FormatException

s 不是有效 IP 端點。