IPAddress 建構函式

定義

初始化 IPAddress 類別的新執行個體。

多載

IPAddress(Byte[])

使用指定為 IPAddress 陣列的位址,初始化 Byte 類別的新執行個體。

IPAddress(Int64)

使用指定為 IPAddress 的位址,初始化 Int64 類別的新執行個體。

IPAddress(ReadOnlySpan<Byte>)

使用指定為位元組範圍的位址,初始化 IPAddress 類別的新執行個體。

IPAddress(Byte[], Int64)

使用指定為 IPAddress 陣列且具有指定之範圍識別項的位址,初始化 Byte 類別的新執行個體。

IPAddress(ReadOnlySpan<Byte>, Int64)

使用指定為位元組範圍且具有指定範圍識別碼的位址,初始化 IPAddress 類別的新執行個體。

IPAddress(Byte[])

來源:
IPAddress.cs
來源:
IPAddress.cs
來源:
IPAddress.cs

使用指定為 IPAddress 陣列的位址,初始化 Byte 類別的新執行個體。

public IPAddress (byte[] address);

參數

address
Byte[]

IP 位址的位元組陣列值。

例外狀況

addressnull

address 包含錯誤的 IP 位址。

備註

會建立 ,IPAddressAddress並將 屬性設定為 address

如果的 address 長度為 4, IPAddress(Byte[]) 則會建構 IPv4 位址,否則會建構範圍為 0 的 IPv6 位址。

Byte陣列假設為以網路位元組順序排列,且索引位置0中第一個最重要的位元組。

適用於

.NET 9 及其他版本
產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

IPAddress(Int64)

來源:
IPAddress.cs
來源:
IPAddress.cs
來源:
IPAddress.cs

使用指定為 IPAddress 的位址,初始化 Int64 類別的新執行個體。

public IPAddress (long newAddress);

參數

newAddress
Int64

IP 位址的長整數值。 例如,位元組由大到小格式的 0x2414188f 值將為 IP 位址 "143.24.20.36"。

例外狀況

newAddress < 0 或

newAddress > 0x00000000FFFFFFFF

備註

IPAddress實體會建立,Address並將屬性設定為 newAddress

此值 Int64 假設為以網路位元組順序排列。

適用於

.NET 9 及其他版本
產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

IPAddress(ReadOnlySpan<Byte>)

來源:
IPAddress.cs
來源:
IPAddress.cs
來源:
IPAddress.cs

使用指定為位元組範圍的位址,初始化 IPAddress 類別的新執行個體。

public IPAddress (ReadOnlySpan<byte> address);

參數

address
ReadOnlySpan<Byte>

IP 位址的位元組表示法依網路位元組順序,並在索引位置 0 有最大顯著性位元組優先。

例外狀況

address 包含錯誤的 IP 位址。

備註

會建立 ,IPAddressAddress並將 屬性設定為 address

如果 的 address 長度為 4,此方法會建構 IPv4 位址,否則會建構範圍為 0 的 IPv6 位址。

適用於

.NET 9 及其他版本
產品 版本
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

IPAddress(Byte[], Int64)

來源:
IPAddress.cs
來源:
IPAddress.cs
來源:
IPAddress.cs

使用指定為 IPAddress 陣列且具有指定之範圍識別項的位址,初始化 Byte 類別的新執行個體。

public IPAddress (byte[] address, long scopeid);

參數

address
Byte[]

IP 位址的位元組陣列值。

scopeid
Int64

範圍識別項的長整數值。

例外狀況

addressnull

address 包含錯誤的 IP 位址。

scopeid < 0 或

scopeid > 0x00000000FFFFFFFF

備註

此建構函式會具現化 IPv6 位址。 會在 scopeid 連結本機地址的情況下識別網路介面。 範圍僅適用於連結本機和月臺本機位址。

Byte陣列假設為以網路位元組順序排列,且索引位置0中第一個最重要的位元組。

適用於

.NET 9 及其他版本
產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

IPAddress(ReadOnlySpan<Byte>, Int64)

來源:
IPAddress.cs
來源:
IPAddress.cs
來源:
IPAddress.cs

使用指定為位元組範圍且具有指定範圍識別碼的位址,初始化 IPAddress 類別的新執行個體。

public IPAddress (ReadOnlySpan<byte> address, long scopeid);

參數

address
ReadOnlySpan<Byte>

IP 位址的位元組範圍值。

scopeid
Int64

範圍識別項的長整數值。

例外狀況

address 包含錯誤的 IP 位址。

scopeid < 0

-或-

scopeid > 0x00000000FFFFFFFF

備註

此建構函式會具現化 IPv6 位址。 會在 scopeid 連結本機地址的情況下識別網路介面。 範圍僅適用於連結本機和月臺本機位址。

位元組範圍假設為以網路位元組順序排列,且索引位置0中第一個最重要的位元組。

適用於

.NET 9 及其他版本
產品 版本
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1