Dns.BeginGetHostByName メソッド

.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)

C#

[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
)

J#

/** @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 メソッドを使用します。

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

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

.NET Framework のセキュリティ

• DnsPermission  (DNS 情報にアクセスするために必要なアクセス許可)。PermissionState.Unrestricted (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)
.NET Compact Framework
サポート対象 : 1.0
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

関連項目
Dns クラス
Dns メンバ
System.Net 名前空間
その他の技術情報
Asynchronous Calls