Dns.GetHostAddressesAsync Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.NameResolution.dll

Surcharges

GetHostAddressesAsync(String, AddressFamily, CancellationToken)	Retourne les adresses IP de l'hôte spécifié en tant qu'opération asynchrone.
GetHostAddressesAsync(String, CancellationToken)	Retourne les adresses IP de l'hôte spécifié en tant qu'opération asynchrone.
GetHostAddressesAsync(String)	Retourne les adresses IP de l'hôte spécifié en tant qu'opération asynchrone.

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Source:

Dns.cs

Retourne les adresses IP de l'hôte spécifié en tant qu'opération asynchrone.

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

Paramètres

hostNameOrAddress

String

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

family

AddressFamily

Famille d’adresses pour laquelle les adresses IP doivent être récupérées. Si la valeur est Unspecified, récupérez toutes les adresses IP, quelle que soit la famille d’adresses.

cancellationToken

CancellationToken

Jeton d’annulation qui peut être utilisé pour signaler que l’opération asynchrone doit être annulée.

Retours

Task<IPAddress[]>

Objet de tâche représentant l'opération asynchrone. La propriété Result 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 paramètre hostNameOrAddress.

Exceptions

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par GetHostAddresses(String, AddressFamily).

GetHostAddressesAsync(String, CancellationToken)

Source:

Dns.cs

Retourne les adresses IP 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, 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())

Paramètres

hostNameOrAddress

String

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

cancellationToken

CancellationToken

Jeton d’annulation qui peut être utilisé pour signaler que l’opération asynchrone doit être annulée.

Retours

Task<IPAddress[]>

Objet de tâche représentant l'opération asynchrone. La propriété Result 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 paramètre hostNameOrAddress.

Exceptions

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par GetHostAddresses(String).

GetHostAddressesAsync(String)

Source:

Dns.cs

Retourne les adresses IP 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 de l'hôte ou adresse IP à résoudre.

Retours

Task<IPAddress[]>

Objet de tâche représentant l'opération asynchrone. La propriété Result 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 paramètre hostNameOrAddress.

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

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

Cette méthode interroge 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.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par GetHostAddresses(String).