Dns.GetHostAddressesAsync メソッド

ソース:

Dns.cs

ソース:

Dns.cs

ソース:

Dns.cs

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Net.Sockets.AddressFamily family, System.Threading.CancellationToken cancellationToken = default);

static member GetHostAddressesAsync : string * System.Net.Sockets.AddressFamily * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, family As AddressFamily, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPAddress())

パラメーター

戻り値

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、hostNameOrAddress パラメーターで指定されたホストの IP アドレスを保持する IPAddress 型の配列を返します。

例外

注釈

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

ソース:

Dns.cs

ソース:

Dns.cs

ソース:

Dns.cs

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Threading.CancellationToken cancellationToken);

static member GetHostAddressesAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, cancellationToken As CancellationToken) As Task(Of IPAddress())

パラメーター

戻り値

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、hostNameOrAddress パラメーターで指定されたホストの IP アドレスを保持する IPAddress 型の配列を返します。

例外

注釈

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

ソース:

Dns.cs

ソース:

Dns.cs

ソース:

Dns.cs

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress);

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress);

static member GetHostAddressesAsync : string -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String) As Task(Of IPAddress())

パラメーター

戻り値

非同期操作を表すタスク オブジェクト。 タスク オブジェクトの Result プロパティは、hostNameOrAddress パラメーターで指定されたホストの IP アドレスを保持する IPAddress 型の配列を返します。

例外

注釈

この操作はブロックされません。 が解決されると、返された Task<TResult> オブジェクトは完了 hostNameOrAddress します。

このメソッドは、ホスト名に関連付けられている IP アドレスを DNS サーバーに照会します。 が IP アドレスの場合 hostNameOrAddress 、このアドレスは DNS サーバーに対してクエリを実行せずに返されます。

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