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


Dns.GetHostAddressesAsync Метод

Определение

Перегрузки

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

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

GetHostAddressesAsync(String, CancellationToken)

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

GetHostAddressesAsync(String)

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

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Исходный код:
Dns.cs
Исходный код:
Dns.cs
Исходный код:
Dns.cs

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

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Net.Sockets.AddressFamily family, System.Threading.CancellationToken cancellationToken = default);
static member GetHostAddressesAsync : string * System.Net.Sockets.AddressFamily * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>
Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, family As AddressFamily, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPAddress())

Параметры

hostNameOrAddress
String

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

family
AddressFamily

Семейство адресов, для которого должны быть получены IP-адреса. Если Unspecifiedзадано значение , получите все IP-адреса независимо от семейства адресов.

cancellationToken
CancellationToken

Токен отмены, который может быть использован для указания на отмену асинхронной операции.

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

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Массив типа IPAddress, в котором содержатся IP-адреса для узла, указанного в параметре hostNameOrAddress.

Исключения

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые GetHostAddresses(String, AddressFamily).

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

GetHostAddressesAsync(String, CancellationToken)

Исходный код:
Dns.cs
Исходный код:
Dns.cs
Исходный код:
Dns.cs

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

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress, System::Threading::CancellationToken cancellationToken);
public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Threading.CancellationToken cancellationToken);
static member GetHostAddressesAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>
Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, cancellationToken As CancellationToken) As Task(Of IPAddress())

Параметры

hostNameOrAddress
String

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

cancellationToken
CancellationToken

Токен отмены, который может быть использован для указания на отмену асинхронной операции.

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

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Массив типа IPAddress, в котором содержатся IP-адреса для узла, указанного в параметре hostNameOrAddress.

Исключения

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые GetHostAddresses(String).

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

GetHostAddressesAsync(String)

Исходный код:
Dns.cs
Исходный код:
Dns.cs
Исходный код:
Dns.cs

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

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress);
public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress);
static member GetHostAddressesAsync : string -> System.Threading.Tasks.Task<System.Net.IPAddress[]>
Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String) As Task(Of IPAddress())

Параметры

hostNameOrAddress
String

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

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

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Массив типа IPAddress, в котором содержатся IP-адреса для узла, указанного в параметре hostNameOrAddress.

Исключения

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

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

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

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после hostNameOrAddress разрешения .

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые GetHostAddresses(String).

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