Dns.GetHostAddresses(String) Método

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

Parâmetros

Retornos

Uma matriz de tipo IPAddress que contém os endereços IP do host especificado pelo hostNameOrAddress parâmetro.

Exceções

Exemplos

O exemplo de código a seguir usa o GetHostAddresses método para resolver um endereço IP para uma matriz de tipo 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

Comentários

O GetHostAddresses método consulta o subsistema DNS para os endereços IP associados a um nome de host. Se hostNameOrAddress for um endereço IP, esse endereço será retornado sem consultar o servidor DNS.

Se uma cadeia de caracteres vazia for passada como o hostNameOrAddress argumento, esse método retornará os endereços IPv4 e IPv6 do host local.

Os endereços IPv6 serão filtrados dos resultados do GetHostAddresses método se o computador local não tiver o IPv6 instalado. Como resultado, é possível recuperar uma instância vazia IPAddress se apenas os resultados do IPv6 estivessem disponíveis para o hostNameOrAddress parâmetro.

Esse método é implementado usando as APIs de resolução de nomes do sistema operacional subjacente (como o getaddrinfo da API Win32 no Windows e APIs equivalentes em outras plataformas). Se um host for descrito no arquivo, o hosts endereço IP ou endereços serão retornados sem consultar o servidor DNS.