Dns.GetHostEntry Methode

Definition

Namespace:: System.Net

Assemblys:: netstandard.dll, System.Net.NameResolution.dll

Assembly:: System.Net.NameResolution.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Löst einen Hostnamen oder eine IP-Adresse in eine IPHostEntry Instanz auf.

Überlädt

Name	Beschreibung
GetHostEntry(IPAddress)	Löst eine IP-Adresse in eine IPHostEntry Instanz auf.
GetHostEntry(String)	Löst einen Hostnamen oder eine IP-Adresse in eine IPHostEntry Instanz auf.
GetHostEntry(String, AddressFamily)	Löst einen Hostnamen oder eine IP-Adresse in eine IPHostEntry Instanz auf.

GetHostEntry(IPAddress)

Quelle:: Dns.cs

Quelle:: Dns.cs

Quelle:: Dns.cs

Quelle:: Dns.cs

Quelle:: Dns.cs

Löst eine IP-Adresse in eine IPHostEntry Instanz auf.

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

Eine IP-Adresse.

Gibt zurück

IPHostEntry

Eine IPHostEntry Instanz, die Adressinformationen über den in addressder Datei angegebenen Host enthält.

Ausnahmen

ArgumentNullException

address ist null.

SocketException

Beim Auflösen addressist ein Fehler aufgetreten.

ArgumentException

address ist eine ungültige IP-Adresse.

Beispiele

Im folgenden Codebeispiel wird die GetHostEntry Methode verwendet, um eine IP-Adresse in eine IPHostEntry Instanz aufzulösen.

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 für die IP-Adressen und Aliase ab, die einer IP-Adresse zugeordnet sind.

IPv6-Adressen werden aus den Ergebnissen der GetHostEntry Methode gefiltert, wenn der lokale Computer IPv6 nicht installiert hat. Daher ist es möglich, eine leere IPHostEntry Instanz zurückzuholen, wenn nur IPv6-Ergebnisse für den address Parameter verfügbar waren.

Die Aliases Eigenschaft der IPHostEntry zurückgegebenen Instanz wird von dieser Methode nicht aufgefüllt und ist immer leer.

Hinweis

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.

Gilt für:

GetHostEntry(String)

Quelle:: Dns.cs

Quelle:: Dns.cs

Quelle:: Dns.cs

Quelle:: Dns.cs

Quelle:: Dns.cs

Löst einen Hostnamen oder eine IP-Adresse in eine IPHostEntry Instanz auf.

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

Der Hostname oder die IP-Adresse, die aufgelöst werden soll.

Gibt zurück

IPHostEntry

Eine IPHostEntry Instanz, die Adressinformationen über den in hostNameOrAddressder Datei angegebenen Host enthält.

Ausnahmen

ArgumentNullException

Der hostNameOrAddress Parameter ist null.

ArgumentOutOfRangeException

Die Länge des hostNameOrAddress Parameters ist größer als 255 Zeichen.

SocketException

Fehler beim Auflösen des hostNameOrAddress Parameters.

ArgumentException

Der hostNameOrAddress Parameter ist eine ungültige IP-Adresse.

Beispiele

Im folgenden Beispiel wird die GetHostEntry Methode verwendet, um eine IP-Adresse in eine IPHostEntry Instanz aufzulösen.

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 für die IP-Adresse ab, die einem Hostnamen oder einer IP-Adresse zugeordnet ist.

Wenn eine leere Zeichenfolge als hostNameOrAddress Argument übergeben wird, gibt diese Methode die IPv4- und IPv6-Adressen des lokalen Hosts zurück.

Wenn der Hostname nicht gefunden wurde, wird die SocketException Ausnahme mit dem Wert 11001 zurückgegeben (Windows Sockets-Fehler WSAHOST_NOT_FOUND). Diese Ausnahme kann zurückgegeben werden, wenn der DNS-Server nicht reagiert. Diese Ausnahme kann auch zurückgegeben werden, wenn es sich bei dem Namen nicht um einen offiziellen Hostnamen oder Alias handelt oder die Datenbank(n) nicht gefunden wird, die abgefragt wird.

Die ArgumentException Ausnahme wird auch zurückgegeben, wenn der hostNameOrAddress Parameter enthält Any oder IPv6Any.

Bei der GetHostEntry Methode wird davon ausgegangen, dass beim Übergeben einer IP-Literalzeichenfolge im hostNameOrAddress Parameter eine IPHostEntry Instanz zurückgegeben werden soll, die mit allen eigenschaften festgelegt wird. Zu diesen Eigenschaften gehören die AddressList, Aliasesund HostName. Daher zeigt die Implementierung der GetHostEntry Methode das folgende Verhalten an, wenn ein IP-Zeichenfolgenliteral übergeben wird:

Die Methode versucht, die Adresse zu analysieren. Wenn der hostNameOrAddress Parameter ein legales IP-Zeichenfolgenliteral enthält, ist die erste Phase erfolgreich.
Es wird versucht, einen Umgekehrten Nachschlagevorgang mithilfe der IP-Adresse des IP-Zeichenfolgenliterals abzurufen, um den Hostnamen abzurufen. Dieses Ergebnis wird als HostName Eigenschaft festgelegt.
Der Hostname aus dieser umgekehrten Suche wird erneut verwendet, um alle möglichen IP-Adressen abzurufen, die dem Namen zugeordnet sind und als AddressList Eigenschaft festgelegt werden.

Bei einem IPv4-Zeichenfolgenliteral können alle drei vorstehenden Schritte erfolgreich sein. Es ist jedoch möglich, dass ein veralteter DNS-Eintrag für eine IPv4-Adresse, die tatsächlich zu einem anderen Host gehört, zurückgegeben werden kann. Dies kann dazu führen, dass Schritt 3 fehlschlägt und eine Ausnahme auslöst (es gibt einen DNS-PTR-Eintrag für die IPv4-Adresse, aber keinen DNS-A-Eintrag für die IPv4-Adresse).

Bei IPv6 kann Schritt 2 fehlschlagen, da die meisten IPv6-Bereitstellungen den Reversedatensatz (PTR) für eine IPv6-Adresse nicht registrieren. Daher kann diese Methode die Zeichenfolge IPv6-Literal als vollqualifizierten Domänenhostnamen (FQDN) in der HostName Eigenschaft zurückgeben.

Die GetHostAddresses Methode hat ein anderes Verhalten in Bezug auf IP-Literale. Wenn Schritt 1 oben erfolgreich ist (es wird erfolgreich als IP-Adresse analysiert), wird diese Adresse sofort als Ergebnis zurückgegeben. Es gibt keinen Versuch, einen umgekehrten Nachschlagevorgang zu versuchen.

Die Aliases Eigenschaft der IPHostEntry zurückgegebenen Instanz wird von dieser Methode nicht aufgefüllt und ist immer leer.

Hinweis

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.

Gilt für:

GetHostEntry(String, AddressFamily)

Quelle:: Dns.cs

Quelle:: Dns.cs

Quelle:: Dns.cs

Quelle:: Dns.cs

Quelle:: Dns.cs

Löst einen Hostnamen oder eine IP-Adresse in eine IPHostEntry Instanz auf.

public:
 static System::Net::IPHostEntry ^ GetHostEntry(System::String ^ hostNameOrAddress, System::Net::Sockets::AddressFamily family);

public static System.Net.IPHostEntry GetHostEntry(string hostNameOrAddress, System.Net.Sockets.AddressFamily family);

static member GetHostEntry : string * System.Net.Sockets.AddressFamily -> System.Net.IPHostEntry

Public Shared Function GetHostEntry (hostNameOrAddress As String, family As AddressFamily) As IPHostEntry

Parameter

hostNameOrAddress: String

Der Hostname oder die IP-Adresse, die aufgelöst werden soll.

family: AddressFamily

Die Adressfamilie, für die IPs abgerufen werden sollen. Wenn Unspecified, rufen Sie alle IPs unabhängig von der Adressfamilie ab.

Gibt zurück

IPHostEntry

Eine IPHostEntry Instanz, die die Adressinformationen über den in hostNameOrAddressder Datei angegebenen Host enthält.

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

Dns.GetHostEntry Methode

Definition

Überlädt

GetHostEntry(IPAddress)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

GetHostEntry(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

GetHostEntry(String, AddressFamily)

Parameter

Gibt zurück

Gilt für:

Feedback