Dns.BeginGetHostByName-Methode

HINWEIS: Diese Methode ist mittlerweile veraltet.

Beginnt eine asynchrone Anforderung von IPHostEntry-Informationen zu den angegebenen DNS-Hostnamen.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
<ObsoleteAttribute("BeginGetHostByName is obsoleted for this type, please use BeginGetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202")> _
Public Shared Function BeginGetHostByName ( _
    hostName As String, _
    requestCallback As AsyncCallback, _
    stateObject As Object _
) As IAsyncResult
'Usage
Dim hostName As String
Dim requestCallback As AsyncCallback
Dim stateObject As Object
Dim returnValue As IAsyncResult

returnValue = Dns.BeginGetHostByName(hostName, requestCallback, stateObject)

[ObsoleteAttribute("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
)

[ObsoleteAttribute(L"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
)

/** @attribute ObsoleteAttribute("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
)

ObsoleteAttribute("BeginGetHostByName is obsoleted for this type, please use BeginGetHostEntry instead. https://go.microsoft.com/fwlink/?linkid=14202") 
public static function BeginGetHostByName (
    hostName : String, 
    requestCallback : AsyncCallback, 
    stateObject : Object
) : IAsyncResult

Parameter

• hostName
  Der DNS-Name des Hosts.

• requestCallback
  Ein AsyncCallback-Delegat, der auf die Methode verweist, die aufgerufen wird, wenn der Vorgang abgeschlossen wurde.

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

Rückgabewert

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

Ausnahmen

Hinweise

Der asynchrone BeginGetHostByName-Vorgang muss durch Aufrufen der EndGetHostByName-Methode abgeschlossen werden. Normalerweise wird die Methode vom requestCallback-Delegaten aufgerufen.

Diese Methode wird erst blockiert, wenn der Vorgang abgeschlossen ist. Wenn Sie die Methode bis zum Abschluss des Vorgangs blockieren möchten, verwenden Sie die GetHostByName-Methode.

Ausführliche Informationen zum Verwenden des asynchronen Programmiermodells finden Sie unter Asynchrones Aufrufen von synchronen Methoden.

.NET Framework-Sicherheit

• DnsPermission  für den Zugriff auf DNS-Informationen. Zugeordnete Enumeration: PermissionState.Unrestricted

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 1.0, 1.1
Veraltet (Compilerwarnung) in 2.0

.NET Compact Framework

Unterstützt in: 1.0
Veraltet (Compilerwarnung) in 2.0

Siehe auch

Referenz

Dns-Klasse
Dns-Member
System.Net-Namespace

Weitere Ressourcen

Asynchronous Calls