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

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

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

Поделиться через