Dns.GetHostAddresses Метод

Определение

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

Перегрузки

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

Возвращает IP-адреса для указанного узла.
GetHostAddresses(String, AddressFamily)

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

GetHostAddresses(String)

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

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

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

Параметры

hostNameOrAddress
String

Имя узла или IP-адрес для разрешения.

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

IPAddress[]

Массив типа IPAddress , содержащий IP-адреса узла, указанного параметром hostNameOrAddress .

Исключения

ArgumentNullException

hostNameOrAddress равно null.

ArgumentOutOfRangeException

Длина hostNameOrAddress больше 255 символов.

SocketException

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

ArgumentException

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

Примеры

В следующем примере кода метод используется GetHostAddresses для разрешения IP-адреса в массив типа IPAddress.

public static void DoGetHostAddresses(string hostname)
{
    IPAddress[] addresses = Dns.GetHostAddresses(hostname);

    Console.WriteLine($"GetHostAddresses({hostname}) returns:");

    foreach (IPAddress address in addresses)
    {
        Console.WriteLine($"    {address}");
    }
}

Public Sub DoGetHostAddresses(hostName As String)

    Dim addresses As IPAddress() = Dns.GetHostAddresses(hostname)

    Console.WriteLine($"GetHostAddresses({hostname}) returns:")

    Dim index As Integer
    For index = 0 To addresses.Length - 1
        Console.WriteLine($"    {addresses(index)}")
    Next index

End Sub

Комментарии

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

Если в качестве аргумента hostNameOrAddress передается пустая строка, этот метод возвращает адреса IPv4 и IPv6 локального узла.

Адреса IPv6 фильтруются из результатов GetHostAddresses метода, если локальный компьютер не установлен IPv6. В результате можно вернуть пустой IPAddress экземпляр, если для hostNameOrAddress параметра были доступны только результаты IPv6.

Этот метод реализуется с помощью API разрешения имен базовой операционной системы (например, API Win32 getaddrinfo в Windows и эквивалентных API на других платформах). Если узел описан в hosts файле, IP-адрес или адреса будут возвращены без запроса DNS-сервера.

Note

Этот член выдает сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

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

GetHostAddresses(String, AddressFamily)

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

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

public:
 static cli::array <System::Net::IPAddress ^> ^ GetHostAddresses(System::String ^ hostNameOrAddress, System::Net::Sockets::AddressFamily family);
public static System.Net.IPAddress[] GetHostAddresses(string hostNameOrAddress, System.Net.Sockets.AddressFamily family);
static member GetHostAddresses : string * System.Net.Sockets.AddressFamily -> System.Net.IPAddress[]
Public Shared Function GetHostAddresses (hostNameOrAddress As String, family As AddressFamily) As IPAddress()

Параметры

hostNameOrAddress
String

Имя узла или IP-адрес для разрешения.

family
AddressFamily

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

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

IPAddress[]

Массив типа IPAddress , содержащий IP-адреса узла, указанного параметром hostNameOrAddress .

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