IPEndPoint.TryParse 方法

定義

命名空間:

System.Net

組件:

System.Net.Primitives.dll

多載

TryParse(ReadOnlySpan<Char>, IPEndPoint)	嘗試將以唯讀範圍表示的 IP 網路端點 (位址和連接埠) 轉換為其對等 IPEndPoint，並傳回指出轉換是否成功的值。
TryParse(String, IPEndPoint)	嘗試將以字串表示的 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 位址，而且您可能會預期這個方法傳回 false。 修正此 Bug 會中斷現有的應用程式，因此不會變更目前的行為。 您的程式代碼可以避免這種行為，方法是確保它只使用這個方法來剖析虛線十進位格式的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

當此方法傳回時，這會是 IPEndPoint 版本的 s。

傳回

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

當此方法傳回時，這會是 IPEndPoint 版本的 s。

傳回

Boolean

如果 s 可以剖析為 IP 端點，則為 true；否則為 false。