Dns.GetHostAddresses Método

Origem:

Dns.cs

Origem:

Dns.cs

Origem:

Dns.cs

Origem:

Dns.cs

Origem:

Dns.cs

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

Devoluções

Um array do tipo IPAddress que contém os endereços IP do host especificados pelo hostNameOrAddress parâmetro.

Exceções

Exemplos

O exemplo de código seguinte utiliza o GetHostAddresses método para resolver um endereço IP para um array do 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

Observações

O GetHostAddresses método consulta o subsistema DNS para os endereços IP associados a um nome de anfitrião. Se hostNameOrAddress for um endereço IP, este endereço é devolvido sem consultar o servidor DNS.

Se uma string vazia for passada como hostNameOrAddress argumento, então este método devolve os endereços IPv4 e IPv6 do host local.

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

Este método é implementado usando as APIs de resolução de nomes do sistema operativo subjacente (como a API Win32 getaddrinfo no Windows, e APIs equivalentes noutras plataformas). Se um host for descrito no hosts ficheiro, o endereço IP ou endereços aí presentes serão devolvidos sem consultar o servidor DNS.

Origem:

Dns.cs

Origem:

Dns.cs

Origem:

Dns.cs

Origem:

Dns.cs

Origem:

Dns.cs

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

Devoluções

Um array do tipo IPAddress que contém os endereços IP do host especificados pelo hostNameOrAddress parâmetro.