Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Methode

Definition

Gibt asynchron die IP-Adressen für den angegebenen Host zurück.Asynchronously returns the Internet Protocol (IP) addresses for the specified host.

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback requestCallback, object state);
static member BeginGetHostAddresses : string * AsyncCallback * obj -> IAsyncResult
Public Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parameter

hostNameOrAddress
String

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

requestCallback
AsyncCallback

Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss des Vorgangs aufgerufen werden soll.An AsyncCallback delegate that references the method to invoke when the operation is complete.

state
Object

Ein benutzerdefiniertes Objekt, das Informationen über den Vorgang enthält.A user-defined object that contains information about the operation. Dieses Objekt wird bei Abschluss des Vorgangs an den requestCallback-Delegaten übergeben.This object is passed to the requestCallback delegate when the operation is complete.

Gibt zurück

Eine IAsyncResult-Instanz, die auf die asynchrone Anforderung verweist.An IAsyncResult instance that references the asynchronous request.

Ausnahmen

hostNameOrAddress ist null.hostNameOrAddress is null.

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

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

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

Hinweise

Die BeginGetHostAddresses-Methode fragt asynchron einen DNS-Server nach den IP-Adressen ab, die einem Hostnamen zugeordnet sind.The BeginGetHostAddresses method asynchronously queries a DNS server for the IP addresses that are associated with a host name. Wenn hostNameOrAddress eine IP-Adresse ist, wird diese Adresse zurückgegeben, ohne den DNS-Server abzufragen.If hostNameOrAddress is an IP address, this address is returned without querying the DNS server.

Hinweis

Dieser Member gibt Ablauf Verfolgungs Informationen aus, wenn Sie die Netzwerk Ablauf Verfolgung in der Anwendung aktivieren.This member emits trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

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

Der asynchrone BeginGetHostAddresses Vorgang muss abgeschlossen werden, indem die EndGetHostAddresses-Methode aufgerufen wird.The asynchronous BeginGetHostAddresses operation must be completed by calling the EndGetHostAddresses method. In der Regel wird die-Methode vom requestCallback-Delegaten aufgerufen.Typically, the method is invoked by the requestCallback delegate.

Diese Methode wird nicht blockiert, bis der Vorgang beendet ist.This method does not block until the operation is complete. Um zu blockieren, bis der Vorgang beendet ist, verwenden Sie die GetHostAddresses-Methode.To block until the operation is complete, use the GetHostAddresses method.

Weitere Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter Asynchrones Aufrufen synchroner Methoden .For more information about using the asynchronous programming model, see Calling Synchronous Methods Asynchronously

Sicherheit

DnsPermission
für den Zugriff auf DNS-Informationen.for accessing DNS information. Zugehörige Enumeration: UnrestrictedAssociated enumeration: Unrestricted

Gilt für: