Dns.EndResolve メソッド

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

Dns.EndResolve メソッド

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

DNS 情報の非同期要求を終了します。

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

Visual Basic (宣言)

<ObsoleteAttribute("EndResolve is obsoleted for this type,
 please use EndGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")>
 _
Public Shared Function EndResolve
 ( _
    asyncResult As IAsyncResult _
) As IPHostEntry

Visual Basic (使用法)

Dim asyncResult As IAsyncResult
Dim returnValue As IPHostEntry

returnValue = Dns.EndResolve(asyncResult)

C#

[ObsoleteAttribute("EndResolve is obsoleted for this
 type, please use EndGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")]
 
public static IPHostEntry EndResolve (
    IAsyncResult asyncResult
)

C++

[ObsoleteAttribute(L"EndResolve is obsoleted for this
 type, please use EndGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")]
 
public:
static IPHostEntry^ EndResolve (
    IAsyncResult^ asyncResult
)

J#

/** @attribute ObsoleteAttribute("EndResolve is obsoleted for
 this type, please use EndGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")
 */ 
public static IPHostEntry EndResolve (
    IAsyncResult asyncResult
)

JScript

ObsoleteAttribute("EndResolve is obsoleted for this
 type, please use EndGetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")
 
public static function EndResolve
 (
    asyncResult : IAsyncResult
) : IPHostEntry

パラメータ

asyncResult

BeginResolve メソッドへの呼び出しで返された IAsyncResult インスタンス。

戻り値
ホストについての DNS 情報を格納する IPHostEntry オブジェクト。

例外

例外の種類	条件
ArgumentNullException	asyncResult が null 参照 (Visual Basic では Nothing) です。

解説

このメソッドは、操作が完了するまでブロックします。

この操作を同期で実行するには、Resolve メソッドを使用します。

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

使用例

DNS ホスト情報の非同期要求を終了する例を次に示します。

Visual Basic

Class DnsBeginGetHostByName
    
    Class RequestState
        Public host As IPHostEntry
        
        Public Sub New()
            host = Nothing
        End Sub 'New
    End Class 'RequestState
    
    
    Public Shared Sub Main()
     Try
        ' Create an instance of the RequestState class.
        Dim myRequestState As New
 RequestState()
        
        ' Begin an asynchronous request for information such as the
 host name, IP addresses, 
        ' or aliases for the specified URI.
        Dim asyncResult As IAsyncResult = CType(Dns.BeginResolve("www.contoso.com",
 AddressOf RespCallback, myRequestState),IAsyncResult)

        ' Wait until asynchronous call completes.
        While asyncResult.IsCompleted <> True
        End While
        
        Console.WriteLine(("Host name : " + myRequestState.host.HostName))
        Console.WriteLine(ControlChars.Cr + "IP address list :
 ")
        Dim index As Integer
        For index = 0 To myRequestState.host.AddressList.Length
 - 1
            Console.WriteLine(myRequestState.host.AddressList(index))
        Next index
        Console.WriteLine(ControlChars.Cr + "Aliases : ")

        For index = 0 To myRequestState.host.Aliases.Length
 - 1
            Console.WriteLine(myRequestState.host.Aliases(index))
        Next index
    catch e as Exception
            Console.WriteLine("Exception caught!!!")
            Console.WriteLine(("Source : " + e.Source))
            Console.WriteLine(("Message : " + e.Message))
    End Try
    End Sub 'Main
    
    
    Private Shared Sub RespCallback(ar
 As IAsyncResult)
        Try
            ' Convert the IAsyncResult object to a RequestState object.
            Dim tempRequestState As RequestState
 = CType(ar.AsyncState, RequestState)

            ' End the asynchronous request.
            tempRequestState.host = Dns.EndResolve(ar)
            Catch e As ArgumentNullException
            Console.WriteLine("ArgumentNullException caught!!!")
            Console.WriteLine(("Source : " + e.Source))
            Console.WriteLine(("Message : " + e.Message))
            Catch e As Exception
            Console.WriteLine("Exception caught!!!")
            Console.WriteLine(("Source : " + e.Source))
            Console.WriteLine(("Message : " + e.Message))
        End Try
    End Sub 'RespCallback

C#

class DnsBeginGetHostByName
{   
   public static System.Threading.ManualResetEvent
 allDone = null;

   class RequestState
   {
      public IPHostEntry host;
      public RequestState()
      {
         host = null;
      }
   }

   public static void Main()
   {
     allDone = new ManualResetEvent(false);
     // Create an instance of the RequestState class.
     RequestState myRequestState = new RequestState();

     // Begin an asynchronous request for information like host name,
 IP addresses, or 
     // aliases for specified the specified URI.
     IAsyncResult asyncResult = Dns.BeginResolve("www.contoso.com", new
 AsyncCallback(RespCallback), myRequestState );

     // Wait until asynchronous call completes.
     allDone.WaitOne();
     Console.WriteLine("Host name : " + myRequestState.host.HostName);
     Console.WriteLine("\nIP address list : ");
     for(int index=0; index < myRequestState.host.AddressList.Length;
 index++)
     {
       Console.WriteLine(myRequestState.host.AddressList[index]);
     }      
     Console.WriteLine("\nAliases : ");
     for(int index=0; index < myRequestState.host.Aliases.Length;
 index++)
     {
       Console.WriteLine(myRequestState.host.Aliases[index]);
     }      
   }
   
   private static void RespCallback(IAsyncResult
 ar)
   {
     try 
     {
       // Convert the IAsyncResult object to a RequestState object.
       RequestState tempRequestState = (RequestState)ar.AsyncState;
       // End the asynchronous request.
       tempRequestState.host = Dns.EndResolve(ar);
       allDone.Set();
     }
       catch(ArgumentNullException e) 
     {
       Console.WriteLine("ArgumentNullException caught!!!");
       Console.WriteLine("Source : " + e.Source);
       Console.WriteLine("Message : " + e.Message);
     }   
     catch(Exception e)
     {
       Console.WriteLine("Exception caught!!!");
       Console.WriteLine("Source : " + e.Source);
       Console.WriteLine("Message : " + e.Message);
     }
   }
}

C++

public ref class DnsBeginGetHostByName
{
public:
   static System::Threading::ManualResetEvent^ allDone = nullptr;
   ref class RequestState
   {
   public:
      IPHostEntry^ host;
      RequestState()
      {
         host = nullptr;
      }
   };

   static void RespCallback( IAsyncResult^
 ar )
   {
      try
      {
         // Convert the IAsyncResult* Object* to a RequestState Object*.
         RequestState^ tempRequestState = dynamic_cast<RequestState^>(ar->AsyncState);
         
         // End the asynchronous request.
         tempRequestState->host = Dns::EndResolve( ar );
         allDone->Set();
      }
      catch ( ArgumentNullException^ e ) 
      {
         Console::WriteLine( "ArgumentNullException caught!!!" );
         Console::WriteLine( "Source : {0}", e->Source );
         Console::WriteLine( "Message : {0}", e->Message );
      }
      catch ( Exception^ e ) 
      {
         Console::WriteLine( "Exception caught!!!" );
         Console::WriteLine( "Source : {0}", e->Source );
         Console::WriteLine( "Message : {0}", e->Message );
      }
   }
};

int main()
{
   DnsBeginGetHostByName::allDone = gcnew ManualResetEvent( false
 );
   
   // Create an instance of the RequestState class.
   DnsBeginGetHostByName::RequestState^ myRequestState =
      gcnew DnsBeginGetHostByName::RequestState;
   
   // Begin an asynchronous request for information like host name,
 IP addresses, or
   // aliases for specified the specified URI.
   IAsyncResult^ asyncResult = Dns::BeginResolve( "www.contoso.com",
      gcnew AsyncCallback( DnsBeginGetHostByName::RespCallback ), myRequestState
 );
   
   // Wait until asynchronous call completes.
   DnsBeginGetHostByName::allDone->WaitOne();
   Console::WriteLine( "Host name : {0}", myRequestState->host->HostName
 );
   Console::WriteLine( "\nIP address list : " );
   for ( int index = 0; index < myRequestState->host->AddressList->Length;
 index++ )
      Console::WriteLine( myRequestState->host->AddressList[ index ] );
   Console::WriteLine( "\nAliases : " );
   for ( int index = 0; index < myRequestState->host->Aliases->Length;
 index++ )
      Console::WriteLine( myRequestState->host->Aliases[ index ] );
}

J#

class DnsBeginGetHostByName
{
    public static System.Threading.ManualResetEvent
 allDone = null;

    static class RequestState
    {
        public IPHostEntry host;

        public RequestState()
        {
            host = null;
        } //RequestState
    } //RequestState

    public static void main(String[]
 args)
    {
        allDone = new ManualResetEvent(false);
        
        
        // Create an instance of the RequestState class.
        RequestState myRequestState = new DnsBeginGetHostByName.
            RequestState();

        // Begin an asynchronous request for information like 
        // host name, IP addresses, or 
        // aliases for specified the specified URI.
        IAsyncResult asyncResult = Dns.BeginResolve("www.contoso.com",
 
            new AsyncCallback(RespCallback), myRequestState);

        // Wait until asynchronous call completes.
        allDone.WaitOne();
        Console.WriteLine("Host name : " + myRequestState.host.get_HostName());
        Console.WriteLine("\nIP address list : ");
        for (int index = 0; index < myRequestState.host.
            get_AddressList().length; index++) {
            Console.WriteLine(myRequestState.host.get_AddressList().
                get_Item(index));
        }
        Console.WriteLine("\nAliases : ");
        for (int index = 0; index < myRequestState.host.get_Aliases().
            length; index++) {
            Console.WriteLine(myRequestState.host.get_Aliases().
                get_Item(index));
        }
    } //main

    private static void RespCallback(IAsyncResult
 ar)
    {
        try {
            // Convert the IAsyncResult object to a RequestState object.
            RequestState tempRequestState = (RequestState)ar.get_AsyncState();

            // End the asynchronous request.
            tempRequestState.host = Dns.EndResolve(ar);
            allDone.Set();
        }
        catch (ArgumentNullException e) {
            Console.WriteLine("ArgumentNullException caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
        catch (System.Exception e) {
            Console.WriteLine("Exception caught!!!");
            Console.WriteLine("Source : " + e.get_Source());
            Console.WriteLine("Message : " + e.get_Message());
        }
    } //RespCallback
} //DnsBeginGetHostByName

プラットフォーム

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