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

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

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

Dns.BeginGetHostByName メソッド

メモ : このメソッドは、互換性のために残されています。

指定した DNS ホスト名についての IPHostEntry 情報の非同期要求を開始します。

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

Visual Basic (宣言)

<ObsoleteAttribute("BeginGetHostByName is obsoleted for this
 type, please use BeginGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")>
 _
Public Shared Function BeginGetHostByName
 ( _
    hostName As String, _
    requestCallback As AsyncCallback, _
    stateObject As Object _
) As IAsyncResult

Visual Basic (使用法)

Dim hostName As String
Dim requestCallback As AsyncCallback
Dim stateObject As Object
Dim returnValue As IAsyncResult

returnValue = Dns.BeginGetHostByName(hostName, requestCallback, stateObject)

[ObsoleteAttribute("BeginGetHostByName is obsoleted for this
 type, please use BeginGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")]
 
public static IAsyncResult BeginGetHostByName
 (
    string hostName,
    AsyncCallback requestCallback,
    Object stateObject
)

C++

[ObsoleteAttribute(L"BeginGetHostByName is obsoleted for
 this type, please use BeginGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")]
 
public:
static IAsyncResult^ BeginGetHostByName (
    String^ hostName, 
    AsyncCallback^ requestCallback, 
    Object^ stateObject
)

/** @attribute ObsoleteAttribute("BeginGetHostByName is obsoleted for
 this type, please use BeginGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")
 */ 
public static IAsyncResult BeginGetHostByName
 (
    String hostName, 
    AsyncCallback requestCallback, 
    Object stateObject
)

JScript

ObsoleteAttribute("BeginGetHostByName is obsoleted for this
 type, please use BeginGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")
 
public static function BeginGetHostByName
 (
    hostName : String, 
    requestCallback : AsyncCallback, 
    stateObject : Object
) : IAsyncResult

パラメータ

hostName: ホストの DNS 名。

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

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

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

例外

例外の種類	条件
ArgumentNullException	hostName が null 参照 (Visual Basic では Nothing) です。
SocketException	DNS クエリの実行中にエラーが発生しました。

解説

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

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

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

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