Dns.BeginGetHostAddresses(String, AsyncCallback, Object) メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.NameResolution.dll

ソース:

Dns.cs

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

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);

public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback? requestCallback, object? state);

static member BeginGetHostAddresses : string * AsyncCallback * obj -> IAsyncResult

Public Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResult

パラメーター

hostNameOrAddress

String

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

requestCallback

AsyncCallback

操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。

state

Object

操作に関する情報を格納するユーザー定義のオブジェクト。 このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。

戻り値

IAsyncResult

非同期要求を参照する IAsyncResult インスタンス。

例外

ArgumentNullException

hostNameOrAddress が nullです。

ArgumentOutOfRangeException

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

SocketException

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

ArgumentException

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

注釈

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

注意

このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。

空の文字列が引数として hostNameOrAddress 渡された場合、このメソッドはローカル ホストの IPv4 アドレスと IPv6 アドレスを返します。

非同期 BeginGetHostAddresses 操作は、 メソッドを呼び出して完了する EndGetHostAddresses 必要があります。 通常、 メソッドはデリゲートによって requestCallback 呼び出されます。

このメソッドは、操作が完了するまでブロックしません。 操作が完了するまでブロックするには、 メソッドを使用します GetHostAddresses 。

非同期プログラミング モデルの使用の詳細については、「非同期的に同期メソッドを呼び出す」を参照してください。