Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Methode

Definition

Namespace:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

Gibt asynchron die IP-Adressen (Internet Protocol) 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);
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 Hostname oder die IP-Adresse, die aufgelöst werden soll.

requestCallback
AsyncCallback

Ein AsyncCallback Delegat, der auf die Methode verweist, die aufgerufen werden soll, wenn der Vorgang abgeschlossen ist.

state
Object

Ein benutzerdefiniertes Objekt, das Informationen zum Vorgang enthält. Dieses Objekt wird an die requestCallback Stellvertretung übergeben, wenn der Vorgang abgeschlossen ist.

Gibt zurück

IAsyncResult

Eine IAsyncResult Instanz, die auf die asynchrone Anforderung verweist.

Ausnahmen

ArgumentNullException

hostNameOrAddress ist null.

ArgumentOutOfRangeException

Die Länge beträgt hostNameOrAddress mehr als 255 Zeichen.

SocketException

Beim Auflösen hostNameOrAddressist ein Fehler aufgetreten.

ArgumentException

hostNameOrAddress ist eine ungültige IP-Adresse.

Hinweise

Die BeginGetHostAddresses Methode fragt asynchron einen DNS-Server für die 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.

Note

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .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 requestCallback Regel wird die Methode vom 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 "Synchrone Methoden asynchron aufrufen"

Gilt für: