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。 呼叫 ConnectAsync 方法所建立之任何 Socket 的 AddressFamily 屬性，將會是成功建立連線之第一個位址的位址系列（不一定是要解析的第一個位址）。

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) 建構函式可用來使用主機名或代表IP位址、埠和位址家族的字串，初始化 DnsEndPoint 類別。

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