Dns.EndResolve(IAsyncResult) 方法

定義

命名空間:

System.Net

組件:

netstandard.dll, System.Net.NameResolution.dll

來源:

Dns.cs

警告

EndResolve has been deprecated. Use EndGetHostEntry instead.

結束 DNS 資訊的非同步要求。

[System.Obsolete("EndResolve has been deprecated. Use EndGetHostEntry instead.")]
public static System.Net.IPHostEntry EndResolve(IAsyncResult asyncResult);

參數

asyncResult

IAsyncResult

IAsyncResult 執行個體，呼叫 BeginResolve(String, AsyncCallback, Object) 方法時傳回。

傳回

IPHostEntry

IPHostEntry 物件，包含關於主機的 DNS 資訊。

屬性

ObsoleteAttribute

例外狀況

ArgumentNullException

asyncResult 為 null。

範例

下列範例會結束 DNS 主機資訊的異步要求。

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);
     }
   }
}

備註

這個方法會封鎖直到作業完成為止。

Ipv6Element.Enabled如果 設定為 true，則Aliases傳回之 實例的 IPHostEntry 屬性不會由這個方法填入，而且一律為空白。

若要同步執行這項作業，請使用 Resolve 方法。

注意

當您在應用程式中啟用網路追蹤時，此成員會發出追蹤資訊。 如需詳細資訊，請參閱 .NET Framework 中的網路追蹤。

適用於

另請參閱

• 異步程序設計概觀