Dns.GetHostAddressesAsync Methode

Definition

Überlädt

Name Beschreibung
GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Gibt die IP-Adressen (Internet Protocol) für den angegebenen Host als asynchronen Vorgang zurück.

GetHostAddressesAsync(String, CancellationToken)

Gibt die IP-Adressen (Internet Protocol) für den angegebenen Host als asynchronen Vorgang zurück.

GetHostAddressesAsync(String)

Gibt die IP-Adressen (Internet Protocol) für den angegebenen Host als asynchronen Vorgang zurück.

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Quelle:
Dns.cs
Quelle:
Dns.cs
Quelle:
Dns.cs
Quelle:
Dns.cs
Quelle:
Dns.cs

Gibt die IP-Adressen (Internet Protocol) 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 Hostname oder die IP-Adresse, die aufgelöst werden soll.

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 den asynchronen Vorgang zu signalisieren, sollte abgebrochen werden.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result Eigenschaft für das Taskobjekt gibt ein Array vom Typ IPAddress zurück, das die IP-Adressen für den Host enthält, der durch den hostNameOrAddress Parameter angegeben wird.

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von GetHostAddresses(String, AddressFamily).

Gilt für:

GetHostAddressesAsync(String, CancellationToken)

Quelle:
Dns.cs
Quelle:
Dns.cs
Quelle:
Dns.cs
Quelle:
Dns.cs
Quelle:
Dns.cs

Gibt die IP-Adressen (Internet Protocol) 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 Hostname oder die IP-Adresse, die aufgelöst werden soll.

cancellationToken
CancellationToken

Ein Abbruchtoken, das verwendet werden kann, um den asynchronen Vorgang zu signalisieren, sollte abgebrochen werden.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result Eigenschaft für das Taskobjekt gibt ein Array vom Typ IPAddress zurück, das die IP-Adressen für den Host enthält, der durch den hostNameOrAddress Parameter angegeben wird.

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von GetHostAddresses(String).

Gilt für:

GetHostAddressesAsync(String)

Quelle:
Dns.cs
Quelle:
Dns.cs
Quelle:
Dns.cs
Quelle:
Dns.cs
Quelle:
Dns.cs

Gibt die IP-Adressen (Internet Protocol) 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 Hostname oder die IP-Adresse, die aufgelöst werden soll.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result Eigenschaft für das Taskobjekt gibt ein Array vom Typ IPAddress zurück, das die IP-Adressen für den Host enthält, der durch den hostNameOrAddress Parameter angegeben wird.

Ausnahmen

hostNameOrAddress ist null.

Die Länge beträgt hostNameOrAddress mehr als 255 Zeichen.

Beim Auflösen hostNameOrAddressist ein Fehler aufgetreten.

hostNameOrAddress ist eine ungültige IP-Adresse.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem das hostNameOrAddress Objekt aufgelöst wurde.

Diese Methode fragt 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.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von GetHostAddresses(String).

Gilt für: