共用方式為

IPGlobalProperties.GetUnicastAddressesAsync 方法

  • 參考

定義

命名空間:
System.Net.NetworkInformation
組件:
System.Net.NetworkInformation.dll
組件:
System.dll
組件:
netstandard.dll
來源:
IPGlobalProperties.cs
來源:
IPGlobalProperties.cs
來源:
IPGlobalProperties.cs

以非同步作業的方式，從本機電腦擷取穩定單點傳播 IP 位址表格。

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)

傳回

Task<UnicastIPAddressInformationCollection>

工作物件，表示非同步作業。

例外狀況

NetworkInformationException

呼叫原生 GetAdaptersAddresses 函式失敗。

SecurityException

呼叫端沒有必要的 Read 權限。

Win32Exception

呼叫原生 NotifyStableUnicastIpAddressTable 函式失敗。

備註

為了支援輸出連線或接受 Teredo 介面上的連入連線，應用程式必須確定 Teredo 介面已啟動且可供使用。 這是因為 Teredo 可以在未使用一段時間時進入休眠狀態。

方法 GetUnicastAddressesAsync 可讓應用程式擷取穩定單播IP位址清單做為異步操作。 屬性 IPAddress.IsIPv6Teredo 可用來判斷IP位址是否為前置詞為2001：：/32的IPv6 Teredo 位址。

此方法 GetUnicastAddresses 也會傳回非 Teredo 位址，並提供更方便的方式來取得系統的單播 IP 位址，而不是列舉本機電腦上的所有 System.Net.NetworkInformation.NetworkInterface 物件，以及查詢相關聯的 IP 位址。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 GetUnicastAddresses()例外狀況。

適用於

另請參閱