Język

Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Metoda

Definicja

Przestrzeń nazw:
System.Net
Zestawy:
netstandard.dll, System.Net.NameResolution.dll
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
Źródło:
Dns.cs
Źródło:
Dns.cs

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 do wywołania po zakończeniu operacji.

state
Object

Obiekt zdefiniowany przez użytkownika zawierający informacje o operacji. Ten obiekt jest przekazywany do delegata po zakończeniu requestCallback operacji.

Zwraca

IAsyncResult

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

Wyjątki

ArgumentNullException

Parametr hostNameOrAddress ma wartość null.

ArgumentOutOfRangeException

Długość hostNameOrAddress znaku 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ń względem serwera DNS.

Note

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

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

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

Ta metoda nie blokuje się, dopóki operacja nie zostanie ukończona. Aby zablokować operację do momentu zakończenia operacji, użyj GetHostAddresses metody .

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

Dotyczy