Dns.GetHostAddressesAsync(String) Méthode

Définition

Espace de noms:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

Retourne les adresses IP (Internet Protocol) de l’hôte spécifié en tant qu’opération asynchrone.

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

Paramètres

hostNameOrAddress
String

Nom d’hôte ou adresse IP à résoudre.

Retours

Task<IPAddress[]>

Objet de tâche représentant l’opération asynchrone. La Result propriété sur l’objet de tâche retourne un tableau de type IPAddress qui contient les adresses IP de l’hôte spécifié par le hostNameOrAddress paramètre.

Exceptions

ArgumentNullException

hostNameOrAddress a la valeur null.

ArgumentOutOfRangeException

La longueur est hostNameOrAddress supérieure à 255 caractères.

SocketException

Une erreur est rencontrée lors de la résolution hostNameOrAddress.

ArgumentException

hostNameOrAddress est une adresse IP non valide.

Remarques

Cette opération ne bloque pas. L’objet retourné Task<TResult> se termine une fois le hostNameOrAddress problème résolu.

Cette méthode interroge un serveur DNS pour les adresses IP associées à un nom d’hôte. S’il hostNameOrAddress s’agit d’une adresse IP, cette adresse est retournée sans interroger le serveur DNS.

Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par GetHostAddresses(String).

S’applique à