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

定義

名前空間:
System.Net
アセンブリ:
netstandard.dll, System.Net.NameResolution.dll
アセンブリ:
System.Net.NameResolution.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll
ソース:
Dns.cs
ソース:
Dns.cs
ソース:
Dns.cs
ソース:
Dns.cs
ソース:
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);
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 サーバーに非同期的に照会します。 hostNameOrAddressが IP アドレスの場合、このアドレスは DNS サーバーに対してクエリを実行せずに返されます。

Note

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

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

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

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

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

適用対象