Dns.GetHostAddressesAsync Método

Definição

Namespace:

System.Net

Assembly:

System.Net.NameResolution.dll

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

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

Task<IPAddress[]>

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

OperationCanceledException

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

GetHostAddressesAsync(String, CancellationToken)

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

Task<IPAddress[]>

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

OperationCanceledException

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

GetHostAddressesAsync(String)

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

Task<IPAddress[]>

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

ArgumentNullException

hostNameOrAddress é null.

ArgumentOutOfRangeException

O tamanho de hostNameOrAddress é maior que 255 caracteres.

SocketException

Um erro foi encontrado durante a resolução de 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 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).