Dns.BeginGetHostAddresses(String, AsyncCallback, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したホストのインターネット プロトコル (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 -> IAsyncResultPublic Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResultパラメーター
- hostNameOrAddress
- String
解決するホスト名または IP アドレス。
- requestCallback
- AsyncCallback
操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。
- state
- Object
操作に関する情報を格納するユーザー定義のオブジェクト。 このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。
戻り値
非同期要求を参照する IAsyncResult インスタンス。
例外
hostNameOrAddress が nullです。
hostNameOrAddress の長さが 255 文字を超えています。
hostNameOrAddress を解決するときにエラーが発生しました。
hostNameOrAddress は無効な IP アドレスです。
注釈
メソッドは BeginGetHostAddresses 、ホスト名に関連付けられている IP アドレスを DNS サーバーに非同期的に照会します。 が IP アドレスの場合 hostNameOrAddress 、このアドレスは DNS サーバーに対してクエリを実行せずに返されます。
注意
このメンバーは、アプリケーションでネットワーク トレースを有効にすると、トレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
空の文字列が引数として hostNameOrAddress 渡された場合、このメソッドはローカル ホストの IPv4 アドレスと IPv6 アドレスを返します。
非同期 BeginGetHostAddresses 操作は、 メソッドを呼び出して完了する EndGetHostAddresses 必要があります。 通常、 メソッドはデリゲートによって requestCallback 呼び出されます。
このメソッドは、操作が完了するまでブロックしません。 操作が完了するまでブロックするには、 メソッドを使用します GetHostAddresses 。
非同期プログラミング モデルの使用の詳細については、「非同期的に同期メソッドを呼び出す」を参照してください。
適用対象
.NET