Dns.GetHostAddresses Método

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

Retornos

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

Exceções

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.

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

Retornos

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