Sdílet prostřednictvím


Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Metoda

Definice

Asynchronně vrátí IP adresy pro zadaného hostitele.

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

Název hostitele nebo IP adresa, které se mají přeložit.

requestCallback
AsyncCallback

Delegát AsyncCallback , který odkazuje na metodu, která se má vyvolat po dokončení operace.

state
Object

Objekt definovaný uživatelem, který obsahuje informace o operaci. Po dokončení operace se tento objekt předá requestCallback delegátu.

Návraty

Instance IAsyncResult , která odkazuje na asynchronní požadavek.

Výjimky

hostNameOrAddress je null.

Délka hostNameOrAddress je větší než 255 znaků.

Při řešení chyby dojde k hostNameOrAddresschybě .

hostNameOrAddress je neplatná IP adresa.

Poznámky

Metoda BeginGetHostAddresses asynchronně dotazuje server DNS na IP adresy, které jsou přidruženy k názvu hostitele. Pokud hostNameOrAddress se jedná o IP adresu, vrátí se tato adresa bez dotazu na server DNS.

Poznámka

Tento člen generuje informace o trasování, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

Pokud se jako hostNameOrAddress argument předá prázdný řetězec, vrátí tato metoda adresy IPv4 a IPv6 místního hostitele.

Asynchronní BeginGetHostAddresses operace musí být dokončena voláním EndGetHostAddresses metody . Obvykle je metoda vyvolána delegátem requestCallback .

Tato metoda neblokuje, dokud není operace dokončena. Pokud chcete blokovat, dokud se operace dokončí, použijte metodu GetHostAddresses .

Další informace o použití asynchronního programovacího modelu najdete v tématu Asynchronní volání synchronních metod.

Platí pro