Dns.GetHostAddressesAsync Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.NameResolution.dll

Ü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)

Quelle:

Dns.cs

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 IP-Adressen abgerufen werden sollen. Wenn Unspecified, ruft alle IP-Adressen ab, unabhängig von der Adressfamilie.

cancellationToken

CancellationToken

Ein Abbruchtoken, das verwendet werden kann, um zu signalisieren, dass der asynchrone Vorgang abgebrochen werden sollte.

Gibt zurück

Task<IPAddress[]>

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

OperationCanceledException

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

Hinweise

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten GetHostAddresses(String, AddressFamily)Ausnahmen.

GetHostAddressesAsync(String, CancellationToken)

Quelle:

Dns.cs

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

Task<IPAddress[]>

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

OperationCanceledException

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

Hinweise

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten GetHostAddresses(String)Ausnahmen.

GetHostAddressesAsync(String)

Quelle:

Dns.cs

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

Task<IPAddress[]>

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

ArgumentNullException

hostNameOrAddress ist null.

ArgumentOutOfRangeException

hostNameOrAddress ist länger als 255 Zeichen.

SocketException

Beim Auflösen von hostNameOrAddress ist ein Fehler aufgetreten.

ArgumentException

hostNameOrAddress ist keine gültige IP-Adresse.

Hinweise

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

Diese Methode fragt einen DNS-Server nach den 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 sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten GetHostAddresses(String)Ausnahmen.