Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Methode

Definition

Gibt asynchron die IP-Adressen für den angegebenen Host zurück.

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback? requestCallback, 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.

requestCallback
AsyncCallback

Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss des Vorgangs aufgerufen werden soll.

state
Object

Ein benutzerdefiniertes Objekt, das Informationen über den Vorgang enthält. Dieses Objekt wird bei Abschluss des Vorgangs an den requestCallback-Delegaten übergeben.

Gibt zurück

Eine IAsyncResult-Instanz, die auf die asynchrone Anforderung verweist.

Ausnahmen

hostNameOrAddress ist null.

hostNameOrAddress ist länger als 255 Zeichen.

Beim Auflösen von hostNameOrAddress ist ein Fehler aufgetreten.

hostNameOrAddress ist keine gültige IP-Adresse.

Hinweise

Die BeginGetHostAddresses Methode fragt asynchron einen DNS-Server nach den IP-Adressen ab, die einem Hostnamen zugeordnet sind. Wenn hostNameOrAddress es sich um eine IP-Adresse handelt, wird diese Adresse ohne Abfrage des DNS-Servers zurückgegeben.

Hinweis

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

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

Der asynchrone BeginGetHostAddresses Vorgang muss durch Aufrufen der EndGetHostAddresses -Methode abgeschlossen werden. In der Regel wird die -Methode vom requestCallback Delegaten aufgerufen.

Diese Methode wird erst blockiert, wenn der Vorgang abgeschlossen ist. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Sie die GetHostAddresses -Methode.

Weitere Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter Aufrufen synchroner Methoden asynchron.

Gilt für: