IPGlobalProperties.GetUnicastAddressesAsync Methode

  • Referenz

Definition

Namespace:
System.Net.NetworkInformation
Assembly:
System.Net.NetworkInformation.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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.

Gilt für:

Weitere Informationen