Compartilhar via


DnsEndPoint Construtores

Definição

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
Origem:
DnsEndPoint.cs
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

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

O parâmetro host é um null.

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).

Aplica-se a

DnsEndPoint(String, Int32, AddressFamily)

Origem:
DnsEndPoint.cs
Origem:
DnsEndPoint.cs
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

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

- ou -

addressFamily é Unknown.

O parâmetro host é um null.

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).

Aplica-se a