Dns.GetHostByName(String) メソッド

定義

注意事項

GetHostByName is obsoleted for this type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202

注意事項

GetHostByName is obsoleted for this type, please use GetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202

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

public:
 static System::Net::IPHostEntry ^ GetHostByName(System::String ^ hostName);
public static System.Net.IPHostEntry GetHostByName(string hostName);
[System.Obsolete("GetHostByName is obsoleted for this type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")]
public static System.Net.IPHostEntry GetHostByName(string hostName);
[System.Obsolete("GetHostByName is obsoleted for this type, please use GetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202")]
public static System.Net.IPHostEntry GetHostByName(string hostName);
static member GetHostByName : string -> System.Net.IPHostEntry
[<System.Obsolete("GetHostByName is obsoleted for this type, please use GetHostEntry instead. http://go.microsoft.com/fwlink/?linkid=14202")>]
static member GetHostByName : string -> System.Net.IPHostEntry
[<System.Obsolete("GetHostByName is obsoleted for this type, please use GetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202")>]
static member GetHostByName : string -> System.Net.IPHostEntry
Public Shared Function GetHostByName (hostName As String) As IPHostEntry

パラメーター

hostName
String

ホストの DNS 名。

返品

IPHostEntryで指定されたアドレスのホスト情報を格納しているhostName オブジェクト。

属性

例外

hostNamenullです。

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

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

注釈

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

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

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

Note

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

適用対象