Dns.GetHostAddressesAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| GetHostAddressesAsync(String, AddressFamily, CancellationToken) |
Gibt die IP-Adressen für den angegebenen Host als asynchronen Vorgang zurück. |
| GetHostAddressesAsync(String, CancellationToken) |
Gibt die IP-Adressen für den angegebenen Host als asynchronen Vorgang zurück. |
| GetHostAddressesAsync(String) |
Gibt die IP-Adressen für den angegebenen Host als asynchronen Vorgang zurück. |
GetHostAddressesAsync(String, AddressFamily, CancellationToken)
Gibt die IP-Adressen für den angegebenen Host als asynchronen Vorgang zurück.
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())Parameter
- hostNameOrAddress
- String
Der aufzulösende Hostname oder die aufzulösende IP-Adresse.
- family
- AddressFamily
Die Adressfamilie, für die IPs abgerufen werden sollen. Wenn Unspecified, rufen Sie alle IPs unabhängig von der Adressfamilie ab.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das verwendet werden kann, um zu signalisieren, dass der asynchrone Vorgang abgebrochen werden sollte.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt ein Array vom Typ IPAddress zurück, das die IP-Adressen für den Host enthält, der vom hostNameOrAddress-Parameter angegeben wird.
Gilt für
GetHostAddressesAsync(String, CancellationToken)
Gibt die IP-Adressen für den angegebenen Host als asynchronen Vorgang zurück.
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())Parameter
- hostNameOrAddress
- String
Der aufzulösende Hostname oder die aufzulösende IP-Adresse.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das verwendet werden kann, um zu signalisieren, dass der asynchrone Vorgang abgebrochen werden sollte.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt ein Array vom Typ IPAddress zurück, das die IP-Adressen für den Host enthält, der vom hostNameOrAddress-Parameter angegeben wird.
Gilt für
GetHostAddressesAsync(String)
Gibt die IP-Adressen für den angegebenen Host als asynchronen Vorgang zurück.
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())Parameter
- hostNameOrAddress
- String
Der aufzulösende Hostname oder die aufzulösende IP-Adresse.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt ein Array vom Typ IPAddress zurück, das die IP-Adressen für den Host enthält, der vom hostNameOrAddress-Parameter angegeben wird.
Ausnahmen
hostNameOrAddress ist null.
hostNameOrAddress ist länger als 255 Zeichen.
Beim Auflösen von hostNameOrAddress ist ein Fehler aufgetreten.
hostNameOrAddress ist keine gültige IP-Adresse.
Hinweise
Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird nach der hostNameOrAddress Auflösung abgeschlossen.
Diese Methode ruft einen DNS-Server für die IP-Adressen ab, die einem Hostnamen zugeordnet sind. Wenn hostNameOrAddress es sich um eine IP-Adresse handelt, wird diese Adresse ohne Abfrage des DNS-Servers zurückgegeben.