Dns.BeginGetHostByName(String, AsyncCallback, Object) Methode

Definition

Warnung

Diese API ist jetzt veraltet.

Beginnt eine asynchrone Anforderung von IPHostEntry-Informationen zu dem angegebenen DNS-Hostnamen.Begins an asynchronous request for IPHostEntry information about the specified DNS host name.

public:
 static IAsyncResult ^ BeginGetHostByName(System::String ^ hostName, AsyncCallback ^ requestCallback, System::Object ^ stateObject);
[System.Obsolete("Use BeginGetHostEntry instead")]
[System.Obsolete("BeginGetHostByName is obsoleted for this type, please use BeginGetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202")]
[System.Obsolete("BeginGetHostByName is obsoleted for this type, please use BeginGetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202")]
public static IAsyncResult BeginGetHostByName (string hostName, AsyncCallback requestCallback, object stateObject);
static member BeginGetHostByName : string * AsyncCallback * obj -> IAsyncResult
Public Shared Function BeginGetHostByName (hostName As String, requestCallback As AsyncCallback, stateObject As Object) As IAsyncResult

Parameter

hostName
String

Der DNS-Name des Hosts.The DNS name of the host.

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.

stateObject
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.

Attribute

Ausnahmen

hostName ist null.hostName is null.

Bei der Ausführung einer DNS-Abfrage ist ein Fehler aufgetreten.An error was encountered executing the DNS query.

Hinweise

Der asynchrone BeginGetHostByName Vorgang muss abgeschlossen werden, indem die EndGetHostByName-Methode aufgerufen wird.The asynchronous BeginGetHostByName operation must be completed by calling the EndGetHostByName 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 GetHostByName-Methode.To block until the operation is complete, use the GetHostByName method.

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

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.

Sicherheit

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

Gilt für:

Siehe auch