Dns.GetHostByName メソッド

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

Dns.GetHostByName メソッド

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

指定した DNS ホスト名の DNS 情報を取得します。

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim hostName As String
Dim returnValue As IPHostEntry

returnValue = Dns.GetHostByName(hostName)

C#

[ObsoleteAttribute("GetHostByName is obsoleted for this
 type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")]
 
public static IPHostEntry GetHostByName (
    string hostName
)

C++

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

J#

/** @attribute ObsoleteAttribute("GetHostByName is obsoleted for
 this type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")
 */ 
public static IPHostEntry GetHostByName (
    String hostName
)

JScript

ObsoleteAttribute("GetHostByName is obsoleted for this
 type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")
 
public static function GetHostByName
 (
    hostName : String
) : IPHostEntry

パラメータ

hostName

ホストの DNS 名。

戻り値
hostName で指定したアドレスのホスト情報を格納する IPHostEntry オブジェクト。

例外

例外の種類	条件
ArgumentNullException	hostName が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	hostName の長さが 126 文字を超えています。
SocketException	hostName を解決するときにエラーが発生しました。

解説

GetHostByName メソッドは、インターネット DNS サーバーでホスト情報を照会します。ホスト名として空の文字列を渡すと、このメソッドはローカル コンピュータの標準ホスト名を取得します。

DNS 情報への非同期アクセスでは、BeginGetHostByName メソッドと EndGetHostByName メソッドを使用します。

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

使用例

GetHostByName メソッドを使用して、指定した DNS ホスト名の DNS 情報を取得する例を次に示します。

Visual Basic

Public Sub DisplayHostName(hostName As
 [String])
    Try
        ' Call the GetHostByName method, passing a DNS style host name(for
 example,
        ' "www.contoso.com") as an argument to obtain an IPHostEntry
 instance, that 
        ' contains information for the specified host.
        
        Dim hostInfo As IPHostEntry = Dns.GetHostByName(hostName)
        ' Get the IP address list that resolves to the host names contained
 in 
        ' the Alias property.
        Dim address As IPAddress() = hostInfo.AddressList
        ' Get the alias names of the the addresses in the IP address
 list.
        Dim [alias] As [String]() = hostInfo.Aliases
        
        Console.WriteLine(("Host name : " + hostInfo.HostName))
        Console.WriteLine(ControlChars.Cr + "Aliases : ")
        Dim index As Integer
        For index = 0 To [alias].Length - 1
            Console.WriteLine([alias](index))
        Next index
        Console.WriteLine(ControlChars.Cr + "IP address list :
 ")

        For index = 0 To address.Length - 1
            Console.WriteLine(address(index))
        Next index
    Catch e As SocketException
        Console.WriteLine("SocketException caught!!!")
        Console.WriteLine(("Source : " + e.Source))
        Console.WriteLine(("Message : " + e.Message))
    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

C#

 try 
 {
    IPHostEntry hostInfo = Dns.GetHostByName(hostName);
    // 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(Exception e)
 {
     Console.WriteLine("Exception caught!!!");
     Console.WriteLine("Source : " + e.Source);
     Console.WriteLine("Message : " + e.Message);
 }

C++

try
{
   IPHostEntry^ hostInfo = Dns::GetHostByName( hostName );
   
   // Get the IP address list that resolves to the host names contained
 in the
   // Alias property.
   array<IPAddress^>^address = hostInfo->AddressList;
   
   // Get the alias names of the addresses in the IP address list.
   array<String^>^alias = hostInfo->Aliases;
   Console::WriteLine( "Host name : {0}", 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 : {0}", e->Source );
   Console::WriteLine( "Message : {0}", e->Message );
}
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 );
}

J#

try {
    IPHostEntry hostInfo = Dns.GetHostByName(hostName);

    // Get the IP address list that resolves to the host 
    // names contained in the  Alias property.
    IPAddress address[] = hostInfo.get_AddressList();

    // Get the alias names of the addresses in the IP address list.
    String alias[] = hostInfo.get_Aliases();

    Console.WriteLine("Host name : " + hostInfo.get_HostName());
    Console.WriteLine("\nAliases : ");
    for (int index = 0; index < alias.length;
 index++) {
        Console.WriteLine(alias.get_Item(index));
    }
    Console.WriteLine("\nIP address list : ");
    for (int index = 0; index < address.length;
 index++) {
        Console.WriteLine(address.get_Item(index));
    }
}
catch (SocketException e) {
    Console.WriteLine("SocketException caught!!!");
    Console.WriteLine("Source : " + e.get_Source());
    Console.WriteLine("Message : " + e.get_Message());
}
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());
}

.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 名前空間