Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert asynchroon de IP-adressen (Internet Protocol) voor de opgegeven 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 -> IAsyncResultPublic Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResultParameters
- hostNameOrAddress
- String
De hostnaam of het IP-adres dat moet worden omgezet.
- requestCallback
- AsyncCallback
Een AsyncCallback gemachtigde die verwijst naar de methode die moet worden aangeroepen wanneer de bewerking is voltooid.
- state
- Object
Een door de gebruiker gedefinieerd object dat informatie over de bewerking bevat. Dit object wordt doorgegeven aan de requestCallback gemachtigde wanneer de bewerking is voltooid.
Retouren
Een IAsyncResult exemplaar dat verwijst naar de asynchrone aanvraag.
Uitzonderingen
hostNameOrAddress is null.
De lengte van hostNameOrAddress meer dan 255 tekens is.
Er is een fout opgetreden bij het oplossen van het probleem hostNameOrAddress.
hostNameOrAddress is een ongeldig IP-adres.
Opmerkingen
De BeginGetHostAddresses methode voert asynchroon een query uit op een DNS-server voor de IP-adressen die zijn gekoppeld aan een hostnaam. Als hostNameOrAddress dit een IP-adres is, wordt dit adres geretourneerd zonder een query uit te voeren op de DNS-server.
Note
Dit lid verzendt traceringsgegevens wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.
Als een lege tekenreeks wordt doorgegeven als het hostNameOrAddress argument, retourneert deze methode de IPv4- en IPv6-adressen van de lokale host.
De asynchrone BeginGetHostAddresses bewerking moet worden voltooid door de EndGetHostAddresses methode aan te roepen. Normaal gesproken wordt de methode aangeroepen door de requestCallback gemachtigde.
Deze methode wordt pas geblokkeerd als de bewerking is voltooid. Gebruik de GetHostAddresses methode om te blokkeren totdat de bewerking is voltooid.
Zie Synchrone methoden asynchroon aanroepen voor meer informatie over het gebruik van het asynchrone programmeermodel