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以外のアドレスも返し、ローカル コンピューター上のすべてのSystem.Net.NetworkInformation.NetworkInterfaceオブジェクトを列挙し、関連付けられている IP アドレスに対してクエリを実行するよりも、システムのユニキャスト IP アドレスを取得する便利な方法を提供します。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって GetUnicastAddresses()スローされる例外に関するページを参照してください。

適用対象

こちらもご覧ください