IPGlobalProperties.GetUnicastAddressesAsync Méthode

Définition

Récupère la table des adresses stable sur l'ordinateur local en tant qu'opération asynchrone.

public:
 virtual System::Threading::Tasks::Task<System::Net::NetworkInformation::UnicastIPAddressInformationCollection ^> ^ GetUnicastAddressesAsync();
public virtual System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection> GetUnicastAddressesAsync ();
abstract member GetUnicastAddressesAsync : unit -> System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection>
override this.GetUnicastAddressesAsync : unit -> System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection>
Public Overridable Function GetUnicastAddressesAsync () As Task(Of UnicastIPAddressInformationCollection)

Retours

Objet de tâche représentant l'opération asynchrone.

Exceptions

L'appel à la fonction GetAdaptersAddresses native a échoué.

L'appelant n'a pas les autorisations Read nécessaires.

L'appel à la fonction NotifyStableUnicastIpAddressTable native a échoué.

Remarques

Pour prendre en charge les connexions sortantes ou pour accepter les connexions entrantes sur une interface Teredo, les applications doivent s’assurer que l’interface Teredo est prête à être utilisée. Cela est dû au fait que Teredo peut passer à un état dormant lorsqu’il n’est pas utilisé pendant une période donnée.

La GetUnicastAddressesAsync méthode permet à une application de récupérer la liste des adresses IP unicast stables en tant qu’opération asynchrone. La IPAddress.IsIPv6Teredo propriété peut être utilisée pour déterminer si une adresse IP est une adresse Teredo IPv6 avec le préfixe 2001 ::/32.

La GetUnicastAddresses méthode retourne également des adresses non-Teredo et fournit un moyen plus pratique d’obtenir les adresses IP unicast pour un système que l’énumération System.Net.NetworkInformation.NetworkInterface de tous les objets sur un ordinateur local et l’interrogation des adresses IP associées.

Cette méthode stocke dans la tâche toutes les exceptions de 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 sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par GetUnicastAddresses().

S’applique à

Voir aussi