Dns.BeginGetHostAddresses(String, AsyncCallback, Object) Метод

  • Ссылка

Определение

Пространство имен:
System.Net
Сборка:
System.Net.NameResolution.dll
Сборка:
System.dll
Сборка:
netstandard.dll
Исходный код:
Dns.cs
Исходный код:
Dns.cs
Исходный код:
Dns.cs

Асинхронно возвращает IP-адреса для указанного узла.

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

Параметры

hostNameOrAddress
String

Разрешаемое имя узла или IP-адрес.

requestCallback
AsyncCallback

Делегат AsyncCallback, ссылающийся на метод, вызываемый по завершении данной операции.

state
Object

Пользовательский объект, содержащий сведения об операции. Этот объект передается делегату requestCallback по завершении операции.

Возвращаемое значение

IAsyncResult

Экземпляр IAsyncResult, который ссылается на асинхронный запрос.

Исключения

ArgumentNullException

hostNameOrAddress имеет значение null.

ArgumentOutOfRangeException

Длина hostNameOrAddress превышает 255 символов.

SocketException

При разрешении hostNameOrAddress возникает ошибка.

ArgumentException

hostNameOrAddress является недопустимым IP-адресом.

Комментарии

Метод BeginGetHostAddresses асинхронно запрашивает у DNS-сервера IP-адреса, связанные с именем узла. Если hostNameOrAddress является IP-адресом, этот адрес возвращается без запроса к DNS-серверу.

Примечание

Этот элемент выдает сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в платформа .NET Framework.

Если в качестве аргумента hostNameOrAddress передается пустая строка, то этот метод возвращает адреса IPv4 и IPv6 локального узла.

Асинхронная BeginGetHostAddresses операция должна быть завершена путем вызова EndGetHostAddresses метода . Как правило, метод вызывается делегатом requestCallback .

Этот метод не блокируется до завершения операции. Чтобы заблокировать до завершения операции, используйте GetHostAddresses метод .

Дополнительные сведения об использовании асинхронной модели программирования см. в статье Вызов синхронных методов в асинхронном режиме.

Применяется к