Dns.GetHostAddresses Método

Definição

Namespace:

System.Net

Assembly:

System.Net.NameResolution.dll

Sobrecargas

GetHostAddresses(String)	Retorna os endereços IP (Internet Protocol) para o host especificado.
GetHostAddresses(String, AddressFamily)	Retorna os endereços IP (Internet Protocol) para o host especificado.

GetHostAddresses(String)

Origem:

Dns.cs

Retorna os endereços IP (Internet Protocol) para o host especificado.

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

hostNameOrAddress

String

O nome do host ou endereço IP a ser resolvido.

Retornos

IPAddress[]

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

Exceções

ArgumentNullException

hostNameOrAddress é null.

ArgumentOutOfRangeException

O tamanho de hostNameOrAddress é maior que 255 caracteres.

SocketException

Um erro foi encontrado durante a resolução de hostNameOrAddress.

ArgumentException

hostNameOrAddress é um endereço IP inválido.

Exemplos

O exemplo de código a seguir usa o GetHostAddresses método para resolver um endereço IP para uma matriz do tipo IPAddress.

    // Determine the Internet Protocol(IP) addresses for a host.
public:
    static void DoGetHostAddress(String^ hostname)
    {
        array<IPAddress^>^ addresses;
        addresses = Dns::GetHostAddresses(hostname);

        Console::WriteLine("GetHostAddresses({0}) returns:", hostname);
        for each (IPAddress^ address in addresses)
        {
            Console::Write("{0} ", address);
        }
        Console::WriteLine("");
   }

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 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 a API do Win32 getaddrinfo no Windows e APIs equivalentes em outras plataformas). Se um host for descrito no arquivo, o hosts endereço IP ou os endereços lá serão retornados sem consultar o servidor DNS.

Observação

Esse membro emite informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.

GetHostAddresses(String, AddressFamily)

Origem:

Dns.cs

Retorna os endereços IP (Internet Protocol) para o host especificado.

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

Parâmetros

hostNameOrAddress

String

O nome do host ou endereço IP a ser resolvido.

family

AddressFamily

A família de endereços para a qual os IPs devem ser recuperados. Se Unspecified, recupere todos os IPs, independentemente da família de endereços.

Retornos

IPAddress[]

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