DnsEndPoint 建構函式

定義

命名空間:

System.Net

組件:

System.Net.Primitives.dll

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

多載

DnsEndPoint(String, Int32)	使用主機名稱或 IP 位址的字串表示以及通訊埠編號，初始化 DnsEndPoint 類別的新執行個體。
DnsEndPoint(String, Int32, AddressFamily)	使用主機名稱或 IP 位址的字串表示、通訊埠編號和位址家族，初始化 DnsEndPoint 類別的新執行個體。

DnsEndPoint(String, Int32)

來源:

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

與位址關聯的通訊埠編號，或 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)

來源:

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

與位址關聯的通訊埠編號，或 0 指定任何可用的通訊埠。 port 依主機順序顯示。

addressFamily

AddressFamily

其中一個 AddressFamily 值。

例外狀況

ArgumentException

host 參數包含空字串。

-或-

addressFamily 為 Unknown。

ArgumentNullException

host 參數為 null。

ArgumentOutOfRangeException

port 小於 MinPort。

-或-

port 大於 MaxPort。

備註

建 DnsEndPoint(String, Int32, AddressFamily) 構函式可用來使用主機名稱或字串來初始化 DnsEndPoint 類別，此字串代表 IP 位址、埠和位址系列。

搭配主機名稱使用建構函式，而不是 IP 位址的字串表示時，位址系列會限制 DNS 解析偏好指定位址系列值的位址。 搭配指定為 Unknown 的位址系列使用建構函式時，即使使用 之後，的 DnsEndPoint 位址系列仍會維持 Unknown 不變。 AddressFamily呼叫 方法所 ConnectAsync 建立之任何 Socket 的 屬性，將會是成功建立連線之第一個位址的位址系列， (不一定是要解析的第一個位址) 。