Dns.GetHostAddressesAsync メソッド

定義

名前空間:

System.Net

アセンブリ:

netstandard.dll, System.Net.NameResolution.dll

オーバーロード

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

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 プロパティは、IPAddress パラメーターで指定されたホストの IP アドレスを保持するhostNameOrAddress型の配列を返します。

例外

ArgumentNullException

hostNameOrAddress は nullです。

ArgumentOutOfRangeException

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

SocketException

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

ArgumentException

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

注釈

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

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

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

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 プロパティは、IPAddress パラメーターで指定されたホストの IP アドレスを保持するhostNameOrAddress型の配列を返します。

例外

OperationCanceledException

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

注釈

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

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 プロパティは、IPAddress パラメーターで指定されたホストの IP アドレスを保持するhostNameOrAddress型の配列を返します。

例外

OperationCanceledException

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

注釈

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