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