DnsEndPoint Construtores

Definição

Inicializa uma nova instância da DnsEndPoint classe.

Sobrecargas

Name Description
DnsEndPoint(String, Int32)

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

DnsEndPoint(String, Int32, AddressFamily)

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

DnsEndPoint(String, Int32)

Inicializa uma nova instância da DnsEndPoint classe com o nome do host ou a representação da cadeia de um endereço IP e um número de 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 em cadeia do endereço IP.

port
Int32

O número de porta associado ao endereço, ou 0 para especificar qualquer porta disponível. port está na ordem do hospedeiro.

Exceções

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

O host parâmetro é um null.

port é inferior a MinPort.

-ou-

port é maior que MaxPort.

Observações

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

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

Aplica-se a

DnsEndPoint(String, Int32, AddressFamily)

Inicializa uma nova instância da DnsEndPoint classe com o nome do host ou a representação de string de um endereço IP, um número de 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 em cadeia do endereço IP.

port
Int32

O número de porta associado ao endereço, ou 0 para especificar qualquer porta disponível. port está na ordem do hospedeiro.

addressFamily
AddressFamily

Um dos AddressFamily valores.

Exceções

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

-ou-

addressFamily é Unknown.

O host parâmetro é um null.

port é inferior a MinPort.

-ou-

port é maior que MaxPort.

Observações

O DnsEndPoint(String, Int32, AddressFamily) construtor pode ser usado para inicializar uma DnsEndPoint classe usando um nome de host ou uma cadeia 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 em cadeia de um endereço IP, a família de endereços restringe a resolução DNS para preferir endereços com o valor especificado da família de endereços. Ao usar o construtor com a família de endereços especificada como Unknown, a família de endereços do DnsEndPoint permanecerá Unknown mesmo após a utilização. A AddressFamily propriedade de qualquer Socket que seja criada por chamadas ao ConnectAsync método será a família de endereços do primeiro endereço ao qual uma ligação pode ser estabelecida com sucesso (não necessariamente o primeiro endereço a ser resolvido).

Aplica-se a