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[])

Source:

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 地址。

注解

IPAddress在将 属性设置为 address的情况下Address创建 。

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

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

IPAddress(Int64)

Source:

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>)

Source:

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 地址。

注解

IPAddress在将 属性设置为 address的情况下Address创建 。

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

IPAddress(Byte[], Int64)

Source:

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)

Source:

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。