DnsEndPoint 构造函数

定义

命名空间:

System.Net

程序集:

System.Net.Primitives.dll

初始化 DnsEndPoint 类的新实例。

重载

DnsEndPoint(String, Int32)	用主机名或 IP 地址和端口号的字符串表示形式初始化 DnsEndPoint 类的新实例。
DnsEndPoint(String, Int32, AddressFamily)	用主机名或 IP 地址、端口号和地址族的字符串表示形式初始化 DnsEndPoint 类的新实例。

DnsEndPoint(String, Int32)

Source:

DnsEndPoint.cs

用主机名或 IP 地址和端口号的字符串表示形式初始化 DnsEndPoint 类的新实例。

public:
 DnsEndPoint(System::String ^ host, int port);

public DnsEndPoint (string host, int port);

new System.Net.DnsEndPoint : string * int -> System.Net.DnsEndPoint

Public Sub New (host As String, port As Integer)

参数

host

String

主机名或 IP 地址的字符串表示形式。

port

Int32

与 address 关联的端口号，或为 0 以指定任何可用端口。 port 以主机顺序排列。

例外

ArgumentException

host 参数包含空字符串。

ArgumentNullException

host 参数为 null。

ArgumentOutOfRangeException

port 小于 MinPort。

- 或 -

port 大于 MaxPort。

注解

构造 DnsEndPoint(String, Int32) 函数可用于使用主机名或表示 IP 地址和端口的字符串初始化 DnsEndPoint 类。 此构造函数将 AddressFamily 属性设置为 Unknown。

将此构造函数与主机名（而不是 IP 地址的字符串表示形式）一起使用时，即使使用 后， DnsEndPoint 的地址系列也会保留 Unknown 。 AddressFamily通过调用 ConnectAsync 方法创建的任何Socket地址的 属性将是可以成功建立连接的第一个地址的地址系列， (不一定是) 要解析的第一个地址。

DnsEndPoint(String, Int32, AddressFamily)

Source:

DnsEndPoint.cs

用主机名或 IP 地址、端口号和地址族的字符串表示形式初始化 DnsEndPoint 类的新实例。

public:
 DnsEndPoint(System::String ^ host, int port, System::Net::Sockets::AddressFamily addressFamily);

public DnsEndPoint (string host, int port, System.Net.Sockets.AddressFamily addressFamily);

new System.Net.DnsEndPoint : string * int * System.Net.Sockets.AddressFamily -> System.Net.DnsEndPoint

Public Sub New (host As String, port As Integer, addressFamily As AddressFamily)

参数

host

String

主机名或 IP 地址的字符串表示形式。

port

Int32

与 address 关联的端口号，或为 0 以指定任何可用端口。 port 以主机顺序排列。

addressFamily

AddressFamily

AddressFamily 值之一。

例外

ArgumentException

host 参数包含空字符串。

- 或 -

addressFamily 为 Unknown。

ArgumentNullException

host 参数为 null。

ArgumentOutOfRangeException

port 小于 MinPort。

- 或 -

port 大于 MaxPort。

注解

构造 DnsEndPoint(String, Int32, AddressFamily) 函数可用于使用主机名或表示 IP 地址、端口和地址系列的字符串初始化 DnsEndPoint 类。

使用具有主机名而不是 IP 地址的字符串表示形式的构造函数时，地址系列会将 DNS 解析限制为首选指定地址系列值的地址。 使用将地址系列指定为 Unknown的构造函数时，即使使用 后， DnsEndPoint 的地址系列也会保留 Unknown 。 AddressFamily通过调用 ConnectAsync 方法创建的任何Socket地址的 属性将是可以成功建立连接的第一个地址的地址系列， (不一定是) 要解析的第一个地址。