IPAddress 建構函式

定義

命名空間:

System.Net

組件:

System.Net.Primitives.dll

初始化 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 陣列的位址，初始化 Byte 類別的新執行個體。

public:
 IPAddress(cli::array <System::Byte> ^ address);

public IPAddress (byte[] address);

new System.Net.IPAddress : byte[] -> System.Net.IPAddress

Public Sub New (address As Byte())

參數

address

Byte[]

IP 位址的位元組陣列值。

例外狀況

ArgumentNullException

address 為 null。

ArgumentException

address 包含錯誤的 IP 位址。

備註

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

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

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

IPAddress(Int64)

來源:

IPAddress.cs

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

public:
 IPAddress(long newAddress);

public IPAddress (long newAddress);

new System.Net.IPAddress : int64 -> System.Net.IPAddress

Public Sub New (newAddress As Long)

參數

newAddress

Int64

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

例外狀況

ArgumentOutOfRangeException

newAddress < 0 或

newAddress > 0x00000000FFFFFFFF

備註

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

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

IPAddress(ReadOnlySpan<Byte>)

來源:

IPAddress.cs

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

public:
 IPAddress(ReadOnlySpan<System::Byte> address);

public IPAddress (ReadOnlySpan<byte> address);

new System.Net.IPAddress : ReadOnlySpan<byte> -> System.Net.IPAddress

Public Sub New (address As ReadOnlySpan(Of Byte))

參數

address

ReadOnlySpan<Byte>

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

例外狀況

ArgumentException

address 包含錯誤的 IP 位址。

備註

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

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

IPAddress(Byte[], Int64)

來源:

IPAddress.cs

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

public:
 IPAddress(cli::array <System::Byte> ^ address, long scopeid);

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

new System.Net.IPAddress : byte[] * int64 -> System.Net.IPAddress

Public Sub New (address As Byte(), scopeid As Long)

參數

address

Byte[]

IP 位址的位元組陣列值。

scopeid

Int64

範圍識別項的長整數值。

例外狀況

ArgumentNullException

address 為 null。

ArgumentException

address 包含錯誤的 IP 位址。

ArgumentOutOfRangeException

scopeid < 0 或

scopeid > 0x00000000FFFFFFFF

備註

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

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

IPAddress(ReadOnlySpan<Byte>, Int64)

來源:

IPAddress.cs

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

public:
 IPAddress(ReadOnlySpan<System::Byte> address, long scopeid);

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

new System.Net.IPAddress : ReadOnlySpan<byte> * int64 -> System.Net.IPAddress

Public Sub New (address As ReadOnlySpan(Of Byte), scopeid As Long)

參數

address

ReadOnlySpan<Byte>

IP 位址的位元組範圍值。

scopeid

Int64

範圍識別項的長整數值。

例外狀況

ArgumentException

address 包含錯誤的 IP 位址。

ArgumentOutOfRangeException

scopeid < 0

-或-

scopeid > 0x00000000FFFFFFFF

備註

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

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