Dns.GetHostAddressesAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Descrição |
|---|---|
| GetHostAddressesAsync(String) |
Devolve os endereços de Protocolo de Internet (IP) para o host especificado como uma operação assíncrona. |
| GetHostAddressesAsync(String, CancellationToken) |
Devolve os endereços de Protocolo de Internet (IP) para o host especificado como uma operação assíncrona. |
| GetHostAddressesAsync(String, AddressFamily, CancellationToken) |
Devolve os endereços de Protocolo de Internet (IP) para o host especificado como uma operação assíncrona. |
GetHostAddressesAsync(String)
- Origem:
- Dns.cs
- Origem:
- Dns.cs
- Origem:
- Dns.cs
- Origem:
- Dns.cs
- Origem:
- Dns.cs
Devolve os endereços de Protocolo de Internet (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 o endereço IP a resolver.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um array do tipo IPAddress que contém os endereços IP do host especificados pelo hostNameOrAddress parâmetro.
Exceções
hostNameOrAddress é null.
O comprimento de hostNameOrAddress é superior a 255 caracteres.
Encontra-se um erro ao resolver hostNameOrAddress.
hostNameOrAddress é um endereço IP inválido.
Observações
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de o hostNameOrAddress ter sido resolvido.
Este método consulta um servidor DNS para os endereços IP associados a um nome de anfitrião. Se hostNameOrAddress for um endereço IP, este endereço é devolvido sem consultar o servidor DNS.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por GetHostAddresses(String).
Aplica-se a
GetHostAddressesAsync(String, CancellationToken)
- Origem:
- Dns.cs
- Origem:
- Dns.cs
- Origem:
- Dns.cs
- Origem:
- Dns.cs
- Origem:
- Dns.cs
Devolve os endereços de Protocolo de Internet (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 o endereço IP a resolver.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado para sinalizar a operação assíncrona deve ser cancelado.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um array do tipo IPAddress que contém os endereços IP do host especificados pelo hostNameOrAddress parâmetro.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por GetHostAddresses(String).
Aplica-se a
GetHostAddressesAsync(String, AddressFamily, CancellationToken)
- Origem:
- Dns.cs
- Origem:
- Dns.cs
- Origem:
- Dns.cs
- Origem:
- Dns.cs
- Origem:
- Dns.cs
Devolve os endereços de Protocolo de Internet (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 o endereço IP a resolver.
- family
- AddressFamily
A família de endereços para a qual os IPs devem ser recuperados. Se Unspecified, recuperar todos os IPs independentemente da família de endereços.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado para sinalizar a operação assíncrona deve ser cancelado.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um array do tipo IPAddress que contém os endereços IP do host especificados pelo hostNameOrAddress parâmetro.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por GetHostAddresses(String, AddressFamily).
