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

定義

指定したホストのインターネット プロトコル (IP) アドレスを非同期的に返します。Asynchronously returns the Internet Protocol (IP) addresses for the specified host.

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 アドレス。The host name or IP address to resolve.

requestCallback
AsyncCallback

操作の完了時に呼び出すメソッドを参照する AsyncCallback デリゲート。An AsyncCallback delegate that references the method to invoke when the operation is complete.

state
Object

操作に関する情報を格納するユーザー定義のオブジェクト。A user-defined object that contains information about the operation. このオブジェクトは、操作の完了時に requestCallback デリゲートに渡されます。This object is passed to the requestCallback delegate when the operation is complete.

戻り値

IAsyncResult

非同期要求を参照する IAsyncResult インスタンス。An IAsyncResult instance that references the asynchronous request.

例外

hostNameOrAddressnullです。hostNameOrAddress is null.

hostNameOrAddress の長さが 255 文字を超えています。The length of hostNameOrAddress is greater than 255 characters.

hostNameOrAddress を解決するときにエラーが発生しました。An error is encountered when resolving hostNameOrAddress.

hostNameOrAddress は無効な IP アドレスです。hostNameOrAddress is an invalid IP address.

注釈

メソッドは、 BeginGetHostAddresses DNS サーバーに対して、ホスト名に関連付けられている IP アドレスを非同期的に照会します。The BeginGetHostAddresses method asynchronously queries a DNS server for the IP addresses that are associated with a host name. hostNameOrAddressが IP アドレスの場合は、DNS サーバーにクエリを実行せずにこのアドレスが返されます。If hostNameOrAddress is an IP address, this address is returned without querying the DNS server.

注意

このメンバーは、アプリケーションでネットワークトレースを有効にするときにトレース情報を出力します。This member emits trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in the .NET Framework.

引数として空の文字列が渡された場合 hostNameOrAddress 、このメソッドはローカルホストの IPv4 アドレスと IPv6 アドレスを返します。If an empty string is passed as the hostNameOrAddress argument, then this method returns the IPv4 and IPv6 addresses of the local host.

非同期操作は、 BeginGetHostAddresses メソッドを呼び出すことによって完了する必要があり EndGetHostAddresses ます。The asynchronous BeginGetHostAddresses operation must be completed by calling the EndGetHostAddresses method. 通常、メソッドはデリゲートによって呼び出され requestCallback ます。Typically, the method is invoked by the requestCallback delegate.

このメソッドは、操作が完了するまでブロックしません。This method does not block until the operation is complete. 操作が完了するまでブロックするには、メソッドを使用し GetHostAddresses ます。To block until the operation is complete, use the GetHostAddresses method.

非同期プログラミングモデルの使用方法の詳細については、「同期メソッドの非同期呼び出し」を参照してください。For more information about using the asynchronous programming model, see Calling Synchronous Methods Asynchronously

適用対象