Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net

Zestaw:: System.Net.NameResolution.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Źródło:: Dns.cs

Źródło:: Dns.cs

Źródło:: Dns.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

IAsyncResult

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

Wyjątki

ArgumentNullException

hostNameOrAddress to null.

ArgumentOutOfRangeException

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

SocketException

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

ArgumentException

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 .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