Dns.GetHostAddressesAsync 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.
Overloads
| Name | Description |
|---|---|
| GetHostAddressesAsync(String, AddressFamily, CancellationToken) |
Retourneert de IP-adressen (Internet Protocol) voor de opgegeven host als asynchrone bewerking. |
| GetHostAddressesAsync(String, CancellationToken) |
Retourneert de IP-adressen (Internet Protocol) voor de opgegeven host als asynchrone bewerking. |
| GetHostAddressesAsync(String) |
Retourneert de IP-adressen (Internet Protocol) voor de opgegeven host als asynchrone bewerking. |
GetHostAddressesAsync(String, AddressFamily, CancellationToken)
- Bron:
- Dns.cs
- Bron:
- Dns.cs
- Bron:
- Dns.cs
- Bron:
- Dns.cs
- Bron:
- Dns.cs
Retourneert de IP-adressen (Internet Protocol) voor de opgegeven host als asynchrone bewerking.
public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync(string hostNameOrAddress, System.Net.Sockets.AddressFamily family, System.Threading.CancellationToken cancellationToken = default);
static member GetHostAddressesAsync : string * System.Net.Sockets.AddressFamily * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>
Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, family As AddressFamily, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPAddress())
Parameters
- hostNameOrAddress
- String
De hostnaam of het IP-adres dat moet worden omgezet.
- family
- AddressFamily
De adresfamilie waarvoor IP-adressen moeten worden opgehaald. Als Unspecifiedu alle IP-adressen ophaalt, ongeacht adresfamilie.
- cancellationToken
- CancellationToken
Een annuleringstoken dat kan worden gebruikt om de asynchrone bewerking te signaleren, moet worden geannuleerd.
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
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
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, AddressFamily)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
GetHostAddressesAsync(String, CancellationToken)
- Bron:
- Dns.cs
- Bron:
- Dns.cs
- Bron:
- Dns.cs
- Bron:
- Dns.cs
- Bron:
- Dns.cs
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, System::Threading::CancellationToken cancellationToken);
public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync(string hostNameOrAddress, System.Threading.CancellationToken cancellationToken);
static member GetHostAddressesAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>
Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, cancellationToken As CancellationToken) As Task(Of IPAddress())
Parameters
- hostNameOrAddress
- String
De hostnaam of het IP-adres dat moet worden omgezet.
- cancellationToken
- CancellationToken
Een annuleringstoken dat kan worden gebruikt om de asynchrone bewerking te signaleren, moet worden geannuleerd.
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
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
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.
Van toepassing op
GetHostAddressesAsync(String)
- Bron:
- Dns.cs
- Bron:
- Dns.cs
- Bron:
- Dns.cs
- Bron:
- Dns.cs
- Bron:
- Dns.cs
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.