Dns.GetHostAddressesAsync Метод

Определение

Пространство имен:
System.Net
Сборки:
netstandard.dll, System.Net.NameResolution.dll
Сборка:
System.Net.NameResolution.dll
Сборка:
System.dll
Сборка:
netstandard.dll

Перегрузки

Имя Описание
GetHostAddressesAsync(String)

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

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

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

GetHostAddressesAsync(String)

Исходный код:
Dns.cs
Исходный код:
Dns.cs
Исходный код:
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-адрес для разрешения.

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

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

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

GetHostAddressesAsync(String, CancellationToken)

Исходный код:
Dns.cs
Исходный код:
Dns.cs
Исходный код:
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

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

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

Task<IPAddress[]>

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

Исключения

OperationCanceledException

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

Комментарии

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

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

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Исходный код:
Dns.cs
Исходный код:
Dns.cs
Исходный код:
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

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

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

Task<IPAddress[]>

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

Исключения

OperationCanceledException

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

Комментарии

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

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