Dns.GetHostAddressesAsync(String) 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 de IP-adressen (Internet Protocol) voor de opgegeven host als asynchrone bewerking.
public:
static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress);public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync(string hostNameOrAddress);static member GetHostAddressesAsync : string -> System.Threading.Tasks.Task<System.Net.IPAddress[]>Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String) As Task(Of IPAddress())Parameters
- hostNameOrAddress
- String
De hostnaam of het IP-adres dat moet worden omgezet.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt. De Result eigenschap op het taakobject retourneert een matrix van het type IPAddress dat de IP-adressen voor de host bevat die is opgegeven door de hostNameOrAddress parameter.
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
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat het hostNameOrAddress is opgelost.
Met deze methode wordt een query uitgevoerd 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.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door GetHostAddresses(String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.