DnsEndPoint Construtores

Definição

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

Inicializa uma nova instância da classe DnsEndPoint.

Sobrecargas

DnsEndPoint(String, Int32)	Inicializa uma nova instância da classe DnsEndPoint com o nome do host ou a representação de cadeia de caracteres de um endereço IP e um número da porta.
DnsEndPoint(String, Int32, AddressFamily)	Inicializa uma nova instância da classe DnsEndPoint com o nome do host ou a representação de cadeia de caracteres de um endereço IP, um número da porta e uma família de endereços.

DnsEndPoint(String, Int32)

Origem:

DnsEndPoint.cs

Inicializa uma nova instância da classe DnsEndPoint com o nome do host ou a representação de cadeia de caracteres de um endereço IP e um número da porta.

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)

Parâmetros

host

String

O nome do host ou uma representação de cadeia de caracteres do endereço IP.

port

Int32

O número da porta associado ao endereço ou 0 para especificar uma porta disponível. port está na ordem de host.

Exceções

ArgumentException

O parâmetro host contém uma cadeia de caracteres vazia.

ArgumentNullException

O parâmetro host é um null.

ArgumentOutOfRangeException

port é menor que MinPort.

- ou -

port é maior que MaxPort.

Comentários

O DnsEndPoint(String, Int32) construtor pode ser usado para inicializar uma DnsEndPoint classe usando um nome de host ou uma cadeia de caracteres que representa um endereço IP e uma porta. Esse construtor define a AddressFamily propriedade como Unknown.

Ao usar esse construtor com um nome de host em vez de uma representação de cadeia de caracteres de um endereço IP, a família de endereços do permanecerá Unknown mesmo após o DnsEndPoint uso. A AddressFamily propriedade de qualquer Socket que é criada por chamadas para o ConnectAsync método será a família de endereços do primeiro endereço para o qual uma conexão pode ser estabelecida com êxito (não necessariamente o primeiro endereço a ser resolvido).

DnsEndPoint(String, Int32, AddressFamily)

Origem:

DnsEndPoint.cs

Inicializa uma nova instância da classe DnsEndPoint com o nome do host ou a representação de cadeia de caracteres de um endereço IP, um número da porta e uma família de endereços.

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)

Parâmetros

host

String

O nome do host ou uma representação de cadeia de caracteres do endereço IP.

port

Int32

O número da porta associado ao endereço ou 0 para especificar uma porta disponível. port está na ordem de host.

addressFamily

AddressFamily

Um dos valores de AddressFamily.

Exceções

ArgumentException

O parâmetro host contém uma cadeia de caracteres vazia.

- ou -

addressFamily é Unknown.

ArgumentNullException

O parâmetro host é um null.

ArgumentOutOfRangeException

port é menor que MinPort.

- ou -

port é maior que MaxPort.

Comentários

O DnsEndPoint(String, Int32, AddressFamily) construtor pode ser usado para inicializar uma DnsEndPoint classe usando um nome de host ou uma cadeia de caracteres que representa um endereço IP, uma porta e uma família de endereços.

Ao usar o construtor com um nome de host em vez de uma representação de cadeia de caracteres de um endereço IP, a família de endereços restringe a resolução DNS para preferir endereços do valor da família de endereços especificado. Ao usar o construtor com a família de endereços especificada como Unknown, a família de endereços do permanecerá Unknown mesmo após o DnsEndPoint uso. A AddressFamily propriedade de qualquer Socket que é criada por chamadas para o ConnectAsync método será a família de endereços do primeiro endereço para o qual uma conexão pode ser estabelecida com êxito (não necessariamente o primeiro endereço a ser resolvido).