Dns.GetHostAddressesAsync メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.NameResolution.dll

オーバーロード

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

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

ソース:

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

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

戻り値

Task<IPAddress[]>

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

例外

OperationCanceledException

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

注釈

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

GetHostAddressesAsync(String, CancellationToken)

ソース:

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

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

戻り値

Task<IPAddress[]>

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

例外

OperationCanceledException

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

注釈

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

GetHostAddressesAsync(String)

ソース:

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 アドレス。

戻り値

Task<IPAddress[]>

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

例外

ArgumentNullException

hostNameOrAddress が nullです。

ArgumentOutOfRangeException

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

SocketException

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

ArgumentException

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

注釈

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

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

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