Share via

IPGlobalProperties.GetUnicastAddressesAsync Methode

  • Referenz

Definition

Namespace:
System.Net.NetworkInformation
Assembly:
System.Net.NetworkInformation.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Quelle:
IPGlobalProperties.cs
Quelle:
IPGlobalProperties.cs
Quelle:
IPGlobalProperties.cs

Ruft die Tabelle der statischen Unicast-IP-Adressen auf dem lokalen Computer als asynchronen Vorgang ab.

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)

Gibt zurück

Task<UnicastIPAddressInformationCollection>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

NetworkInformationException

Der Aufruf der systemeigenen GetAdaptersAddresses-Funktion ist fehlgeschlagen.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Read-Berechtigung.

Win32Exception

Der Aufruf der systemeigenen NotifyStableUnicastIpAddressTable-Funktion ist fehlgeschlagen.

Hinweise

Um ausgehende Verbindungen zu unterstützen oder eingehende Verbindungen auf einer Teredo-Schnittstelle zu akzeptieren, müssen Anwendungen sicherstellen, dass die Teredo-Schnittstelle betriebsbereit und einsatzbereit ist. Dies liegt daran, dass Teredo in einen ruhenden Zustand versetzt werden kann, wenn es für einen bestimmten Zeitraum nicht verwendet wird.

Die GetUnicastAddressesAsync -Methode ermöglicht es einer Anwendung, die Liste der stabilen Unicast-IP-Adressen als asynchronen Vorgang abzurufen. Die IPAddress.IsIPv6Teredo -Eigenschaft kann verwendet werden, um zu bestimmen, ob eine IP-Adresse eine IPv6 Teredo-Adresse mit dem Präfix 2001::/32 ist.

Die GetUnicastAddresses -Methode gibt auch Nicht-Teredo-Adressen zurück und bietet eine bequemere Möglichkeit, die Unicast-IP-Adressen für ein System abzurufen, als alle System.Net.NetworkInformation.NetworkInterface Objekte auf einem lokalen Computer aufzulisten und die zugeordneten IP-Adressen abzufragen.

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden GetUnicastAddresses().

Gilt für:

Weitere Informationen