Udostępnij za pośrednictwem


Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Metoda

Definicja

Asynchronicznie zwraca adresy protokołu internetowego (IP) dla określonego hosta.

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback? requestCallback, object? state);
public static IAsyncResult BeginGetHostAddresses (string hostNameOrAddress, AsyncCallback requestCallback, object state);
static member BeginGetHostAddresses : string * AsyncCallback * obj -> IAsyncResult
Public Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parametry

hostNameOrAddress
String

Nazwa hosta lub adres IP do rozpoznania.

requestCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu operacji.

state
Object

Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji. Ten obiekt jest przekazywany do delegata requestCallback po zakończeniu operacji.

Zwraca

Wystąpienie IAsyncResult , które odwołuje się do żądania asynchronicznego.

Wyjątki

hostNameOrAddress to null.

Długość hostNameOrAddress jest większa niż 255 znaków.

Napotkano błąd podczas rozwiązywania problemu hostNameOrAddress.

hostNameOrAddress jest nieprawidłowym adresem IP.

Uwagi

Metoda BeginGetHostAddresses asynchronicznie wysyła zapytanie do serwera DNS dla adresów IP skojarzonych z nazwą hosta. Jeśli hostNameOrAddress jest to adres IP, ten adres jest zwracany bez wykonywania zapytań dotyczących serwera DNS.

Uwaga

Ten element członkowski emituje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

Jeśli pusty ciąg jest przekazywany jako hostNameOrAddress argument, ta metoda zwraca adresy IPv4 i IPv6 hosta lokalnego.

Operacja asynchroniczna musi zostać ukończona BeginGetHostAddresses przez wywołanie EndGetHostAddresses metody . Zazwyczaj metoda jest wywoływana przez delegata requestCallback .

Ta metoda nie blokuje się do momentu ukończenia operacji. Aby zablokować operację do czasu ukończenia GetHostAddresses operacji, użyj metody .

Aby uzyskać więcej informacji na temat używania modelu programowania asynchronicznego, zobacz Asynchroniczne wywoływanie metod synchronicznych

Dotyczy