Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne de façon asynchrone les adresses IP (Internet Protocol) 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 -> IAsyncResultPublic Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResultParamètres
- hostNameOrAddress
- String
Nom d’hôte ou adresse IP à résoudre.
- requestCallback
- AsyncCallback
Délégué AsyncCallback qui fait référence à la méthode à appeler une fois l’opération terminée.
- state
- Object
Objet défini par l’utilisateur qui contient des informations sur l’opération. Cet objet est transmis au requestCallback délégué une fois l’opération terminée.
Retours
Instance IAsyncResult qui fait référence à la requête asynchrone.
Exceptions
hostNameOrAddress a la valeur null.
La longueur est hostNameOrAddress supérieure à 255 caractères.
Une erreur est rencontrée lors de la résolution hostNameOrAddress.
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. S’il hostNameOrAddress s’agit d’une adresse IP, cette adresse est retournée sans interroger le serveur DNS.
Note
Ce membre émet des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .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 bloque pas tant que l’opération n’est pas terminée. Pour bloquer jusqu’à ce que l’opération soit terminée, 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
