Dns.Resolve(String) メソッド

定義

名前空間:

System.Net

アセンブリ:

netstandard.dll, System.Net.NameResolution.dll

ソース:

Dns.cs

注意事項

Resolve has been deprecated. Use GetHostEntry instead.

DNS ホスト名または IP アドレスを IPHostEntry インスタンスに解決します。

C#

[System.Obsolete("Resolve has been deprecated. Use GetHostEntry instead.")]
public static System.Net.IPHostEntry Resolve(string hostName);

パラメーター

hostName

String

DNS スタイルのホスト名、または IP アドレス。

戻り値

IPHostEntry

hostName で指定するホストについてのアドレス情報を格納する IPHostEntry インスタンス。

属性

ObsoleteAttribute

例外

ArgumentNullException

hostName が nullです。

ArgumentOutOfRangeException

hostName の長さが 255 文字を超えています。

SocketException

hostName を解決するときにエラーが発生しました。

例

次の例では、 メソッドを Resolve 使用して IP アドレスをインスタンスに IPHostEntry 解決します。

C#

try {
    IPHostEntry hostInfo = Dns.Resolve(hostString);
    // Get the IP address list that resolves to the host names contained in the
    // Alias property.
    IPAddress[] address = hostInfo.AddressList;
    // Get the alias names of the addresses in the IP address list.
    String[] alias = hostInfo.Aliases;

    Console.WriteLine("Host name : " + hostInfo.HostName);
    Console.WriteLine("\nAliases : ");
    for(int index=0; index < alias.Length; index++) {
      Console.WriteLine(alias[index]);
    }
    Console.WriteLine("\nIP Address list :");
    for(int index=0; index < address.Length; index++) {
       Console.WriteLine(address[index]);
    }
 }
 catch(SocketException e)
 {
    Console.WriteLine("SocketException caught!!!");
    Console.WriteLine("Source : " + e.Source);
    Console.WriteLine("Message : " + e.Message);
 }
 catch(ArgumentNullException e)
 {
Console.WriteLine("ArgumentNullException caught!!!");
    Console.WriteLine("Source : " + e.Source);
    Console.WriteLine("Message : " + e.Message);
 }
 catch(NullReferenceException e)
 {
     Console.WriteLine("NullReferenceException 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);
 }

注釈

メソッドは Resolve 、ホスト名または IP アドレスに関連付けられている IP アドレスを DNS サーバーに照会します。

が複数の IP アドレスに関連付けられた DNS スタイルのホスト名である場合 hostName 、そのホスト名に解決される最初の IP アドレスのみが返されます。

プロパティが Ipv6Element.Enabled に true設定されている場合、 Aliases 返されるインスタンスの IPHostEntry プロパティはこのメソッドによって設定されず、常に空になります。

注意

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

適用対象