Dns.GetHostEntry Dns.GetHostEntry Dns.GetHostEntry Dns.GetHostEntry Method

Definition

Löst einen Hostnamen oder eine IP-Adresse in eine IPHostEntry-Instanz auf. Resolves a host name or IP address to an IPHostEntry instance.

Überlädt

GetHostEntry(IPAddress) GetHostEntry(IPAddress) GetHostEntry(IPAddress) GetHostEntry(IPAddress)

Löst eine IP-Adresse in eine IPHostEntry-Instanz auf. Resolves an IP address to an IPHostEntry instance.

GetHostEntry(String) GetHostEntry(String) GetHostEntry(String) GetHostEntry(String)

Löst einen Hostnamen oder eine IP-Adresse in eine IPHostEntry-Instanz auf. Resolves a host name or IP address to an IPHostEntry instance.

GetHostEntry(IPAddress) GetHostEntry(IPAddress) GetHostEntry(IPAddress) GetHostEntry(IPAddress)

Löst eine IP-Adresse in eine IPHostEntry-Instanz auf. Resolves an IP address to an IPHostEntry instance.

public:
 static System::Net::IPHostEntry ^ GetHostEntry(System::Net::IPAddress ^ address);
public static System.Net.IPHostEntry GetHostEntry (System.Net.IPAddress address);
static member GetHostEntry : System.Net.IPAddress -> System.Net.IPHostEntry
Public Shared Function GetHostEntry (address As IPAddress) As IPHostEntry
Parameter
address
IPAddress IPAddress IPAddress IPAddress

Eine IP-Adresse. An IP address.

Gibt zurück

Eine IPHostEntry-Instanz, die Adressinformationen zu dem in address angegebenen Host enthält. An IPHostEntry instance that contains address information about the host specified in address.

Ausnahmen

Beim Auflösen von address ist ein Fehler aufgetreten. An error is encountered when resolving address.

address ist keine gültige IP-Adresse. address is an invalid IP address.

Beispiele

Im folgenden Codebeispiel wird die GetHostEntry Methode zum Auflösen einer IP-Adresse in einer IPHostEntry Instanz.The following code example uses the GetHostEntry method to resolve an IP address to an IPHostEntry instance.

public:
    static void DoGetHostEntry(IPAddress^ address)
    {
        IPHostEntry^ host = Dns::GetHostEntry(address);

        Console::WriteLine("GetHostEntry({0}) returns HostName: {1}", address->ToString(), host->HostName);
    }
public static void DoGetHostEntry(IPAddress address)
{
    IPHostEntry host = Dns.GetHostEntry(address);

    Console.WriteLine($"GetHostEntry({address}) returns HostName: {host.HostName}");
}
Public Sub DoGetHostEntry(address As IPAddress)

    Dim host as IPHostEntry = Dns.GetHostEntry(address)

    Console.WriteLine($"GetHostEntry({address}) returns HostName: {host.HostName}")

End Sub

Hinweise

Die GetHostEntry -Methode fragt einen DNS-Server die IP-Adressen und Aliase, die eine IP-Adresse zugeordnet.The GetHostEntry method queries a DNS server for the IP addresses and aliases associated with an IP address.

IPv6-Adressen werden gefiltert, in den Ergebnissen der GetHostEntry Methode, wenn der lokale Computer keine IPv6 installiert werden.IPv6 addresses are filtered from the results of the GetHostEntry method if the local computer does not have IPv6 installed. Es ist daher möglich, eine leere erhalten IPHostEntry Instanz, wenn nur IPv6 verfügbar für Ergebnisse der address Parameter.As a result, it is possible to get back an empty IPHostEntry instance if only IPv6 results where available for the address parameter.

Die Aliases Eigenschaft der IPHostEntry zurückgegebene Instanz wird von dieser Methode nicht aufgefüllt und wird immer leer sein.The Aliases property of the IPHostEntry instance returned is not populated by this method and will always be empty.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn die netzwerkablaufverfolgung in Ihrer Anwendung zu aktivieren.This member emits trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Sicherheit

DnsPermission
für den Zugriff auf DNS-Informationen. for accessing DNS information. Zugeordnete Enumeration: Unrestricted Associated enumeration: Unrestricted

GetHostEntry(String) GetHostEntry(String) GetHostEntry(String) GetHostEntry(String)

Löst einen Hostnamen oder eine IP-Adresse in eine IPHostEntry-Instanz auf. Resolves a host name or IP address to an IPHostEntry instance.

public:
 static System::Net::IPHostEntry ^ GetHostEntry(System::String ^ hostNameOrAddress);
public static System.Net.IPHostEntry GetHostEntry (string hostNameOrAddress);
static member GetHostEntry : string -> System.Net.IPHostEntry
Public Shared Function GetHostEntry (hostNameOrAddress As String) As IPHostEntry
Parameter
hostNameOrAddress
String String String String

Der aufzulösende Hostname oder die aufzulösende IP-Adresse. The host name or IP address to resolve.

Gibt zurück

Eine IPHostEntry-Instanz, die Adressinformationen zu dem in hostNameOrAddress angegebenen Host enthält. An IPHostEntry instance that contains address information about the host specified in hostNameOrAddress.

Ausnahmen

Der hostNameOrAddress-Parameter ist null. The hostNameOrAddress parameter is null.

Der hostNameOrAddress-Parameter ist länger als 255 Zeichen. The length of hostNameOrAddress parameter is greater than 255 characters.

Beim Auflösen des hostNameOrAddress-Parameters ist ein Fehler aufgetreten. An error was encountered when resolving the hostNameOrAddress parameter.

Der hostNameOrAddress-Parameter ist keine gültige IP-Adresse. The hostNameOrAddress parameter is an invalid IP address.

Beispiele

Im folgenden Beispiel wird die GetHostEntry Methode zum Auflösen einer IP-Adresse in einer IPHostEntry Instanz.The following example uses the GetHostEntry method to resolve an IP address to an IPHostEntry instance.

public:
    static void DoGetHostEntry(String^ hostname)
    {
        IPHostEntry^ host = Dns::GetHostEntry(hostname);

        Console::WriteLine("GetHostEntry({0}) returns:", host->HostName);

        for (int i = 0; i < host->AddressList->Length; i++)
        {
            Console::WriteLine("    {0}", host->AddressList[i]->ToString());			
        }
    }
public static void DoGetHostEntry(string hostname)
{
    IPHostEntry host = Dns.GetHostEntry(hostname);

    Console.WriteLine($"GetHostEntry({hostname}) returns:");

    foreach (IPAddress address in host.AddressList)
    {
        Console.WriteLine($"    {address}");
    }
}
Public Sub DoGetHostEntry(hostName As String)

    Dim host as IPHostEntry = Dns.GetHostEntry(hostname)

    Console.WriteLine($"GetHostEntry({hostname}) returns:")

    Dim addresses As IPAddress() = host.AddressList

    Dim index As Integer
    For index = 0 To addresses.Length - 1
        Console.WriteLine($"    {addresses(index)}")
    Next index

End Sub

Hinweise

Die GetHostEntry -Methode fragt einen DNS-Server die IP-Adresse, die mit einem Hostnamen zugeordnet ist oder die IP-Adresse.The GetHostEntry method queries a DNS server for the IP address that is associated with a host name or IP address.

Wenn eine leere Zeichenfolge, als übergeben wird die hostNameOrAddress Argument, und klicken Sie dann auf diese Methode gibt die IPv4- und IPv6-Adressen des lokalen Hosts.If an empty string is passed as the hostNameOrAddress argument, then this method returns the IPv4 and IPv6 addresses of the local host.

Wenn der Hostname nicht gefunden werden konnte, die SocketException Ausnahme mit einem Wert von 11001 (Windows Sockets-Fehler WSAHOST_NOT_FOUND) zurückgegeben.If the host name could not be found, the SocketException exception is returned with a value of 11001 (Windows Sockets error WSAHOST_NOT_FOUND). Diese Ausnahme kann zurückgegeben werden, wenn der DNS-Server nicht antwortet.This exception can be returned if the DNS server does not respond. Diese Ausnahme kann auch zurückgegeben werden, wenn der Name kein offizieller Hostname oder Alias ist, oder es kann nicht in der abgefragten Datenbanken gefunden werden.This exception can also be returned if the name is not an official host name or alias, or it cannot be found in the database(s) being queried.

Die ArgumentException Ausnahme wird auch zurückgegeben, wenn die hostNameOrAddress Parameter enthält Any oder IPv6Any.The ArgumentException exception is also returned if the hostNameOrAddress parameter contains Any or IPv6Any.

Die GetHostEntry Methode setzt voraus, dass wenn eine IP-Literalzeichenfolge übergeben wird die hostNameOrAddress Parameter, der die Anwendung eine IPHostEntry Instanz mit allen festgelegten Eigenschaften zurückgegeben.The GetHostEntry method assumes that if an IP literal string is passed in the hostNameOrAddress parameter that the application wants an IPHostEntry instance returned with all of the properties set. Zu diesen Eigenschaften zählen die AddressList, Aliases, und HostName.These properties include the AddressList, Aliases, and HostName. Als Ergebnis der Implementierung der GetHostEntry Methode weist das folgende Verhalten auf, wenn eine IP-Zeichenfolgenliteral übergeben wird:As a result, the implementation of the GetHostEntry method exhibits the following behavior when an IP string literal is passed:

  1. Die Methode versucht, die Adresse zu analysieren.The method tries to parse the address. Wenn die hostNameOrAddress Parameter enthält, ein gültiges IP-Zeichenfolgenliteral, und klicken Sie dann in der erste Phase erfolgreich ausgeführt wird.If the hostNameOrAddress parameter contains a legal IP string literal, then the first phase succeeds.

  2. Ein reverse-Lookup verwenden die IP-Adresse die IP-Zeichenfolgenliteral wird versucht, um den Namen des Hosts zu erhalten.A reverse lookup using the IP address of the IP string literal is attempted to obtain the host name. Dieses Resultset wird als die HostName Eigenschaft.This result is set as the HostName property.

  3. Der Name des Zielhosts aus diesem reverse-Lookup, erneut verwendet, erhalten alle möglichen IP-Adressen mit dem Namen verknüpft ist, und legen Sie als die AddressList Eigenschaft.The host name from this reverse lookup is used again to obtain all the possible IP addresses associated with the name and set as the AddressList property.

Für das ein IPv4-Zeichenfolgenliteral möglicherweise alle drei oben genannten Schritte erfolgreich ausgeführt.For an IPv4 string literal, all three steps above may succeed. Aber es ist möglich, dass ein veralteter DNS-Eintrag für eine IPv4-Adresse, die tatsächlich gehört zu einem anderen Host zurückgegeben werden.But it is possible for a stale DNS record for an IPv4 address that actually belongs to a different host to be returned. Dies kann dazu führen, dass Schritt #3 fehl und löst eine Ausnahme (es gibt einen DNS-PTR-Eintrag für die IPv4-Adresse, aber kein DNS-A-Eintrag für die IPv4-Adresse).This may cause step #3 to fail and throw an exception (there is a DNS PTR record for the IPv4 address, but no DNS A record for the IPv4 address).

Für IPv6 möglicherweise Schritt #2 fehl, da die meisten Bereitstellungen von IPv6 nicht die reverse Eintrag (PTR) für eine IPv6-Adresse registrieren.For IPv6, step #2 above may fail, since most IPv6 deployments do not register the reverse (PTR) record for an IPv6 address. Diese Methode die IPv6-Zeichenfolge mit dem Namen des Hosts den vollqualifizierten Domänennamen (FQDN) im literal zurück kann die HostName Eigenschaft.So this method may return the string IPv6 literal as the fully-qualified domain (FQDN) host name in the HostName property.

Die GetHostAddresses Methode weist ein anderes Verhalten in Bezug auf IP-Literale.The GetHostAddresses method has different behavior with respect to IP literals. Wenn Schritt #1 erfolgreich ist (er erfolgreich analysiert wird als eine IP-Adresse), die Adresse sofort als Ergebnis zurückgegeben werden.If step #1 above succeeds (it successfully parses as an IP address), that address is immediately returned as the result. Es gibt keinen Versuch einen reverse-Lookup.There is no attempt at a reverse lookup.

IPv6-Adressen werden gefiltert, in den Ergebnissen der GetHostEntry Methode, wenn der lokale Computer keine IPv6 installiert werden.IPv6 addresses are filtered from the results of the GetHostEntry method if the local computer does not have IPv6 installed. Es ist daher möglich, eine leere erhalten IPHostEntry Instanz, wenn nur IPv6 verfügbar für Ergebnisse der hostNameOrAddressParameter.As a result, it is possible to get back an empty IPHostEntry instance if only IPv6 results where available for the hostNameOrAddress.parameter.

Die Aliases Eigenschaft der IPHostEntry zurückgegebene Instanz wird von dieser Methode nicht aufgefüllt und wird immer leer sein.The Aliases property of the IPHostEntry instance returned is not populated by this method and will always be empty.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn die netzwerkablaufverfolgung in Ihrer Anwendung zu aktivieren.This member emits trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Sicherheit

DnsPermission
für den Zugriff auf DNS-Informationen. for accessing DNS information. Zugeordnete Enumeration: Unrestricted Associated enumeration: Unrestricted

Gilt für: