Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Méthode

  • Référence

Définition

Espace de noms:
System.Net
Assembly:
System.Net.NameResolution.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs

Retourne de manière asynchrone les adresses IP de l'hôte spécifié.

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback? requestCallback, object? state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback requestCallback, object state);
static member BeginGetHostAddresses : string * AsyncCallback * obj -> IAsyncResult
Public Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Paramètres

hostNameOrAddress
String

Nom de l'hôte ou adresse IP à résoudre.

requestCallback
AsyncCallback

Délégué AsyncCallback qui fait référence à la méthode à appeler quand l'opération est terminée.

state
Object

Objet défini par l'utilisateur qui comporte des informations sur l'opération. Cet objet est passé au délégué requestCallback quand l'opération est terminée.

Retours

IAsyncResult

Instance de IAsyncResult qui fait référence à la demande asynchrone.

Exceptions

ArgumentNullException

hostNameOrAddress a la valeur null.

ArgumentOutOfRangeException

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

SocketException

Une erreur s'est produite lors de la résolution de hostNameOrAddress.

ArgumentException

hostNameOrAddress est une adresse IP non valide.

Remarques

La BeginGetHostAddresses méthode interroge de façon asynchrone un serveur DNS pour les adresses IP associées à un nom d’hôte. Si hostNameOrAddress est une adresse IP, cette adresse est retournée sans interroger le serveur DNS.

Notes

Ce membre émet des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans le .NET Framework.

Si une chaîne vide est passée en tant qu’argument hostNameOrAddress , cette méthode retourne les adresses IPv4 et IPv6 de l’hôte local.

L’opération asynchrone BeginGetHostAddresses doit être effectuée en appelant la EndGetHostAddresses méthode . En règle générale, la méthode est appelée par le requestCallback délégué.

Cette méthode ne se bloque pas tant que l’opération n’est pas terminée. Pour bloquer jusqu’à la fin de l’opération, utilisez la GetHostAddresses méthode .

Pour plus d’informations sur l’utilisation du modèle de programmation asynchrone, consultez Appel asynchrone de méthodes synchrones

S’applique à