Dns.GetHostByName メソッド
アセンブリ: System (system.dll 内)
構文
<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
Dim hostName As String Dim returnValue As IPHostEntry returnValue = Dns.GetHostByName(hostName)
[ObsoleteAttribute("GetHostByName is obsoleted for this type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")] public static IPHostEntry GetHostByName ( string hostName )
[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 )
/** @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 )
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 で指定したアドレスのホスト情報を格納する IPHostEntry オブジェクト。
GetHostByName メソッドは、インターネット DNS サーバーでホスト情報を照会します。ホスト名として空の文字列を渡すと、このメソッドはローカル コンピュータの標準ホスト名を取得します。
DNS 情報への非同期アクセスでは、BeginGetHostByName メソッドと EndGetHostByName メソッドを使用します。
メモ |
---|
このメンバは、アプリケーションでネットワーク トレースを有効にしている場合にトレース情報を出力します。詳細については、「ネットワークのトレース」を参照してください。 |
GetHostByName メソッドを使用して、指定した DNS ホスト名の DNS 情報を取得する例を次に示します。
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
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); }
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 ); }
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()); }
プラットフォーム
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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)
.NET Compact Framework
サポート対象 : 1.0
2.0 では、互換性のために残されています (コンパイル時に警告)
- Dns.GetHostByName メソッドのページへのリンク