Dns.GetHostAddressesAsync メソッド

定義

オーバーロード

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

指定したホストのインターネット プロトコル (IP) アドレスを非同期操作として返します。

GetHostAddressesAsync(String, CancellationToken)

指定したホストのインターネット プロトコル (IP) アドレスを非同期操作として返します。

GetHostAddressesAsync(String)

指定したホストのインターネット プロトコル (IP) アドレスを非同期操作として返します。

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

ソース:
Dns.cs
ソース:
Dns.cs
ソース:
Dns.cs

指定したホストのインターネット プロトコル (IP) アドレスを非同期操作として返します。

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())

パラメーター

hostNameOrAddress
String

解決するホスト名または IP アドレス。

family
AddressFamily

IP を取得する必要があるアドレス ファミリ。 の場合 Unspecifiedは、アドレス ファミリに関係なくすべての IP を取得します。

cancellationToken
CancellationToken

非同期操作のキャンセルが必要であることを示すために使用できるキャンセル トークン。

戻り値

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

例外

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

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

適用対象

GetHostAddressesAsync(String, CancellationToken)

ソース:
Dns.cs
ソース:
Dns.cs
ソース:
Dns.cs

指定したホストのインターネット プロトコル (IP) アドレスを非同期操作として返します。

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())

パラメーター

hostNameOrAddress
String

解決するホスト名または IP アドレス。

cancellationToken
CancellationToken

非同期操作のキャンセルが必要であることを示すために使用できるキャンセル トークン。

戻り値

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

例外

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

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

適用対象

GetHostAddressesAsync(String)

ソース:
Dns.cs
ソース:
Dns.cs
ソース:
Dns.cs

指定したホストのインターネット プロトコル (IP) アドレスを非同期操作として返します。

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())

パラメーター

hostNameOrAddress
String

解決するホスト名または IP アドレス。

戻り値

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

例外

hostNameOrAddressnullです。

hostNameOrAddress の長さが 255 文字を超えています。

hostNameOrAddress を解決するときにエラーが発生しました。

hostNameOrAddress は無効な IP アドレスです。

注釈

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

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

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

適用対象