IPEndPoint.Parse 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Parse(ReadOnlySpan<Byte>) | |
| 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 |
Important
請注意，此方法接受一個可解析為 Int64的有效值，並將該 Int64 值視為網路位元組順序的 IP 位址長值，類似 IPAddress 建構子的做法。 這表示如果 Int64 成功解析，即使該位址不是有效 IP，這個方法也會回傳為真。 例如，若 s 是「1」，此方法會回傳真，儘管「1」（或 0.0.0.1）並非有效 IP，你可能會預期此方法回傳 false。 修復這個錯誤會破壞現有應用程式，因此目前的行為不會被改變。 你的程式碼可以透過確保只用此方法來解析點數小數格式的 IP 位址，來避免這種情況。
字面上的 IPv6 位址在通過指定埠號的端點時，必須以方括號 [] 包圍;否則，方形牙套並非強制。
Parse(ReadOnlySpan<Byte>)
public:
static System::Net::IPEndPoint ^ Parse(ReadOnlySpan<System::Byte> utf8Text);public static System.Net.IPEndPoint Parse(ReadOnlySpan<byte> utf8Text);static member Parse : ReadOnlySpan<byte> -> System.Net.IPEndPointPublic Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte)) As IPEndPoint參數
- utf8Text
- ReadOnlySpan<Byte>
傳回
適用於
Parse(ReadOnlySpan<Char>)
將一個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.IPEndPointPublic Shared Function Parse (s As ReadOnlySpan(Of Char)) As IPEndPoint參數
- s
- ReadOnlySpan<Char>
一個只讀區間，IPv4 以虛點四邊形符號或網路位元組順序表示 IP 端點，IPv6 則以冒號十六進位表示。
傳回
IP 網路端點的物件表示法。
例外狀況
s 是 null。
s 不是有效的 IP 端點。
適用於
Parse(String)
將以字串表示的 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.IPEndPointPublic Shared Function Parse (s As String) As IPEndPoint參數
- s
- String
包含 IPv4 中點的點數，包含點四邊形符號或網路位元組序，IPv6 則以冒號十六進位表示。
傳回
IP 網路端點的物件表示法。
例外狀況
s 是 null。
s 不是有效的 IP 端點。
