Dns.GetHostAddressesAsync Метод

Определение

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

System.Net

Сборка:

System.Net.NameResolution.dll

Перегрузки

GetHostAddressesAsync(String, AddressFamily, CancellationToken)	Возвращает IP-адреса для указанного узла как асинхронная операция.
GetHostAddressesAsync(String, CancellationToken)	Возвращает IP-адреса для указанного узла как асинхронная операция.
GetHostAddressesAsync(String)	Возвращает IP-адреса для указанного узла как асинхронная операция.

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

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

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

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

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

Task<IPAddress[]>

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

Исключения

OperationCanceledException

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

Комментарии

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

GetHostAddressesAsync(String, CancellationToken)

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

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

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

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

Task<IPAddress[]>

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

Исключения

OperationCanceledException

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

Комментарии

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

GetHostAddressesAsync(String)

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

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-адрес.

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

Task<IPAddress[]>

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

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

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

SocketException

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

ArgumentException

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

Комментарии

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

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

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