Dns.GetHostAddressesAsync(String) Método

Definição

Namespace:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

Retorna os endereços IP (Protocolo de Internet) 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 o endereço IP a ser resolvido.

Retornos

Task<IPAddress[]>

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

Exceções

ArgumentNullException

hostNameOrAddress é null.

ArgumentOutOfRangeException

O comprimento é hostNameOrAddress maior que 255 caracteres.

SocketException

Um erro é encontrado ao resolver hostNameOrAddress.

ArgumentException

hostNameOrAddress é um endereço IP inválido.

Comentários

Essa operação não será bloqueada. O objeto retornado Task<TResult> será concluído após a hostNameOrAddress resolução.

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