次の方法で共有


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

定義

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

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback? requestCallback, 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 インスタンス。

例外

hostNameOrAddressnullです。

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

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

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

注釈

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

注意

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

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

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

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

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

適用対象