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 数组的地址初始化 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 地址的字节数组值。

例外

addressnull

address 包含错误的 IP 地址。

注解

创建 IPAddress 时,将 Address 属性设置为 address

如果 的 address 长度为 4, IPAddress(Byte[]) 则构造 IPv4 地址;否则,构造范围为 0 的 IPv6 地址。

假定 Byte 数组采用网络字节顺序,索引位置 0 中最重要的字节排在第一位。

适用于

IPAddress(Int64)

使用指定为 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”。

例外

newAddress< 0 或

newAddress> 0x00000000FFFFFFFF

注解

创建 IPAddress 实例时, Address 属性设置为 newAddress

假定 Int64 该值采用网络字节顺序。

适用于

IPAddress(ReadOnlySpan<Byte>)

使用指定为字节范围的地址初始化 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 前面。

例外

address 包含错误的 IP 地址。

注解

创建 IPAddress 时,将 Address 属性设置为 address

如果 的 address 长度为 4,则此方法构造 IPv4 地址;否则,将构造范围为 0 的 IPv6 地址。

适用于

IPAddress(Byte[], Int64)

使用指定为 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

范围标识符的长值。

例外

addressnull

address 包含错误的 IP 地址。

scopeid< 0 或

scopeid> 0x00000000FFFFFFFF

注解

此构造函数实例化 IPv6 地址。 在 scopeid 链接本地地址的情况下,标识网络接口。 范围仅对链接本地地址和站点本地地址有效。

假定 Byte 数组采用网络字节顺序,索引位置 0 中最重要的字节排在第一位。

适用于

IPAddress(ReadOnlySpan<Byte>, Int64)

使用指定为字节范围的地址和指定的范围标识符初始化 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

范围标识符的长值。

例外

address 包含错误的 IP 地址。

scopeid< 0

-或-

scopeid> 0x00000000FFFFFFFF

注解

此构造函数实例化 IPv6 地址。 在 scopeid 链接本地地址的情况下,标识网络接口。 范围仅对链接本地地址和站点本地地址有效。

假定字节范围采用网络字节顺序,索引位置 0 中最重要的字节优先。

适用于