Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Metod

Definition

Namnområde:
System.Net
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Asynkront returnerar IP-adresserna (Internet Protocol) för den angivna värden.

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::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

Parametrar

hostNameOrAddress
String

Värdnamnet eller IP-adressen som ska matchas.

requestCallback
AsyncCallback

Ett AsyncCallback ombud som refererar till den metod som ska anropas när åtgärden är klar.

state
Object

Ett användardefinierat objekt som innehåller information om åtgärden. Det här objektet skickas till ombudet requestCallback när åtgärden är klar.

Returer

IAsyncResult

En IAsyncResult instans som refererar till den asynkrona begäran.

Undantag

ArgumentNullException

hostNameOrAddress är null.

ArgumentOutOfRangeException

Längden hostNameOrAddress på är större än 255 tecken.

SocketException

Ett fel påträffas när du löser hostNameOrAddress.

ArgumentException

hostNameOrAddress är en ogiltig IP-adress.

Kommentarer

Metoden BeginGetHostAddresses frågar asynkront en DNS-server efter DE IP-adresser som är associerade med ett värdnamn. Om hostNameOrAddress är en IP-adress returneras den här adressen utan att fråga DNS-servern.

Note

Den här medlemmen genererar spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.

Om en tom sträng skickas som hostNameOrAddress argument returnerar den här metoden IPv4- och IPv6-adresserna för den lokala värden.

Den asynkrona BeginGetHostAddresses åtgärden måste slutföras genom att anropa EndGetHostAddresses metoden. Metoden anropas vanligtvis av ombudet requestCallback .

Den här metoden blockeras inte förrän åtgärden har slutförts. Om du vill blockera tills åtgärden har slutförts använder du GetHostAddresses metoden .

Mer information om hur du använder den asynkrona programmeringsmodellen finns i Anropa synkrona metoder asynkront

Gäller för