IPGlobalProperties.GetUnicastAddressesAsync Metoda

Definice

Obor názvů:

System.Net.NetworkInformation

Sestavení:

System.Net.NetworkInformation.dll

Zdroj:

IPGlobalProperties.cs

Načte stabilní tabulku IP adres jednosměrového vysílání v místním počítači jako asynchronní operaci.

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)

Návraty

Task<UnicastIPAddressInformationCollection>

Objekt úlohy představující asynchronní operaci.

Výjimky

NetworkInformationException

Volání nativní GetAdaptersAddresses funkce selhalo.

SecurityException

Volající nemá potřebná Read oprávnění.

Win32Exception

Volání nativní NotifyStableUnicastIpAddressTable funkce selhalo.

Poznámky

Aby bylo možné podporovat odchozí připojení nebo přijímat příchozí připojení v rozhraní Teredo, musí aplikace zajistit, aby rozhraní Teredo bylo připravené k použití. Je to proto, že Teredo může přejít do neaktivního stavu, pokud se nepoužívá po určitou dobu.

Metoda GetUnicastAddressesAsync umožní aplikaci načíst seznam stabilních IP adres jednosměrového vysílání jako asynchronní operace. Vlastnost IPAddress.IsIPv6Teredo se dá použít k určení, jestli je IP adresa IPv6 Teredo adresa s předponou 2001::/32.

Metoda GetUnicastAddresses také vrací jiné adresy než Teredo a poskytuje pohodlnější způsob, jak získat IP adresy jednosměrového vysílání pro systém než výčet všech System.Net.NetworkInformation.NetworkInterface objektů v místním počítači a dotazování přidružených IP adres.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetUnicastAddresses().

Viz také

• IsIPv6Teredo
• BeginGetUnicastAddresses(AsyncCallback, Object)
• EndGetUnicastAddresses(IAsyncResult)
• GetUnicastAddresses()