Dns.BeginGetHostAddresses メソッド

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

C#

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

C++

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

J#

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 サーバーを照会せずに、このアドレスが返されます。

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

Windows Server 2003 以外のオペレーティング システムの場合、ホスト名として空の文字列が渡されると、このメソッドはローカル ホストの IPv4 アドレスを返します。Windows Server 2003 の場合、ローカル ホストの IPv4 アドレスおよび IPv6 アドレスが返されます。

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

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

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

.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
サポート対象 : 2.0

参照

関連項目
Dns クラス
Dns メンバ
System.Net 名前空間