Partilhar via


Dns.GetHostAddressesAsync Método

Definição

Sobrecargas

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Retorna os endereços IP (protocolo IP) para o host especificado como uma operação assíncrona.

GetHostAddressesAsync(String, CancellationToken)

Retorna os endereços IP (protocolo IP) para o host especificado como uma operação assíncrona.

GetHostAddressesAsync(String)

Retorna os endereços IP (protocolo IP) para o host especificado como uma operação assíncrona.

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Origem:
Dns.cs
Origem:
Dns.cs
Origem:
Dns.cs

Retorna os endereços IP (protocolo IP) para o host especificado como uma operação assíncrona.

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Net.Sockets.AddressFamily family, System.Threading.CancellationToken cancellationToken = default);
static member GetHostAddressesAsync : string * System.Net.Sockets.AddressFamily * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>
Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, family As AddressFamily, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPAddress())

Parâmetros

hostNameOrAddress
String

O nome do host ou endereço IP a ser resolvido.

family
AddressFamily

A família de endereços para a qual os IPs devem ser recuperados. Se Unspecified, recupere todos os IPs, independentemente da família de endereços.

cancellationToken
CancellationToken

Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.

Retornos

O objeto de tarefa que representa a operação assíncrona. A propriedade Result no objeto de tarefa retorna uma matriz do tipo IPAddress que contém os endereços IP para o host especificado pelo parâmetro hostNameOrAddress.

Exceções

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por GetHostAddresses(String, AddressFamily).

Aplica-se a

GetHostAddressesAsync(String, CancellationToken)

Origem:
Dns.cs
Origem:
Dns.cs
Origem:
Dns.cs

Retorna os endereços IP (protocolo IP) para o host especificado como uma operação assíncrona.

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress, System::Threading::CancellationToken cancellationToken);
public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Threading.CancellationToken cancellationToken);
static member GetHostAddressesAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>
Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, cancellationToken As CancellationToken) As Task(Of IPAddress())

Parâmetros

hostNameOrAddress
String

O nome do host ou endereço IP a ser resolvido.

cancellationToken
CancellationToken

Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.

Retornos

O objeto de tarefa que representa a operação assíncrona. A propriedade Result no objeto de tarefa retorna uma matriz do tipo IPAddress que contém os endereços IP para o host especificado pelo parâmetro hostNameOrAddress.

Exceções

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por GetHostAddresses(String).

Aplica-se a

GetHostAddressesAsync(String)

Origem:
Dns.cs
Origem:
Dns.cs
Origem:
Dns.cs

Retorna os endereços IP (protocolo IP) para o host especificado como uma operação assíncrona.

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress);
public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress);
static member GetHostAddressesAsync : string -> System.Threading.Tasks.Task<System.Net.IPAddress[]>
Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String) As Task(Of IPAddress())

Parâmetros

hostNameOrAddress
String

O nome do host ou endereço IP a ser resolvido.

Retornos

O objeto de tarefa que representa a operação assíncrona. A propriedade Result no objeto de tarefa retorna uma matriz do tipo IPAddress que contém os endereços IP para o host especificado pelo parâmetro hostNameOrAddress.

Exceções

hostNameOrAddress é null.

O tamanho de hostNameOrAddress é maior que 255 caracteres.

Um erro foi encontrado durante a resolução de hostNameOrAddress.

hostNameOrAddress é um endereço IP inválido.

Comentários

Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que o hostNameOrAddress tiver sido resolvido.

Esse método consulta um servidor DNS para os endereços IP associados a um nome de host. Se hostNameOrAddress for um endereço IP, esse endereço será retornado sem consultar o servidor DNS.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por GetHostAddresses(String).

Aplica-se a