Dns.GetHostAddressesAsync 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.
Surcharges
| Nom | Description |
|---|---|
| GetHostAddressesAsync(String, AddressFamily, CancellationToken) |
Retourne les adresses IP (Internet Protocol) de l’hôte spécifié en tant qu’opération asynchrone. |
| GetHostAddressesAsync(String, CancellationToken) |
Retourne les adresses IP (Internet Protocol) de l’hôte spécifié en tant qu’opération asynchrone. |
| GetHostAddressesAsync(String) |
Retourne les adresses IP (Internet Protocol) de l’hôte spécifié en tant qu’opération asynchrone. |
GetHostAddressesAsync(String, AddressFamily, CancellationToken)
- Source:
- Dns.cs
- Source:
- Dns.cs
- Source:
- Dns.cs
- Source:
- Dns.cs
- Source:
- Dns.cs
Retourne les adresses IP (Internet Protocol) 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 d’hôte ou adresse IP à résoudre.
- family
- AddressFamily
Famille d’adresses pour laquelle les adresses IP doivent être récupérées. Si Unspecified, récupérez toutes les adresses IP indépendamment de la famille d’adresses.
- cancellationToken
- CancellationToken
Un jeton d’annulation qui peut être utilisé pour signaler que l’opération asynchrone doit être annulée.
Retours
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
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 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, AddressFamily).
S’applique à
GetHostAddressesAsync(String, CancellationToken)
- Source:
- Dns.cs
- Source:
- Dns.cs
- Source:
- Dns.cs
- Source:
- Dns.cs
- Source:
- Dns.cs
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, 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 d’hôte ou adresse IP à résoudre.
- cancellationToken
- CancellationToken
Un jeton d’annulation qui peut être utilisé pour signaler que l’opération asynchrone doit être annulée.
Retours
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
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 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 à
GetHostAddressesAsync(String)
- Source:
- Dns.cs
- Source:
- Dns.cs
- Source:
- Dns.cs
- Source:
- Dns.cs
- Source:
- Dns.cs
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
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
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
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).
