IPGlobalProperties.GetUnicastAddressesAsync メソッド

  • リファレンス

定義

名前空間:
System.Net.NetworkInformation
アセンブリ:
System.Net.NetworkInformation.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll

ローカル コンピューター上の固定のユニキャスト 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 アドレスを取得する便利な方法を提供します。

適用対象

こちらもご覧ください