Dns.BeginGetHostAddresses メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Dns.BeginGetHostAddresses メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim hostNameOrAddress As String
Dim requestCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult

returnValue = Dns.BeginGetHostAddresses(hostNameOrAddress, requestCallback, state)

public static IAsyncResult BeginGetHostAddresses
 (
    string hostNameOrAddress,
    AsyncCallback requestCallback,
    Object state
)

C++

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

public static IAsyncResult BeginGetHostAddresses
 (
    String hostNameOrAddress, 
    AsyncCallback requestCallback, 
    Object state
)

JScript

public static function BeginGetHostAddresses
 (
    hostNameOrAddress : String, 
    requestCallback : AsyncCallback, 
    state : Object
) : IAsyncResult

パラメータ

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

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

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

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

例外

例外の種類	条件
ArgumentNullException	hostNameOrAddress が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	hostNameOrAddress の長さが 126 文字を超えています。
SocketException	hostNameOrAddress を解決するときにエラーが発生しました。
ArgumentException	hostNameOrAddress は無効な IP アドレスです。

解説

BeginGetHostAddresses メソッドは、DNS サーバーでホスト名と関連付けられた IP アドレスを非同期的に照会します。hostNameOrAddress が IP アドレスである場合、DNS サーバーを照会せずに、このアドレスが返されます。

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