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

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.NameResolution.dll

Исходный код:

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);

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 метод .

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