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

Определение

Асинхронно возвращает 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, который ссылается на асинхронный запрос.

Исключения

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

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

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

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

Комментарии

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

Примечание

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

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

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

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

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

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