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

Devoluciones

Matriz de tipo IPAddress que contiene las direcciones IP para el host especificado por el hostNameOrAddress parámetro .

Excepciones

Ejemplos

En el ejemplo de código siguiente se usa el GetHostAddresses método para resolver una dirección IP en una 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

Comentarios

El GetHostAddresses método consulta el subsistema DNS para las direcciones IP asociadas a un nombre de host. Si hostNameOrAddress es una dirección IP, esta dirección se devuelve sin consultar el servidor DNS.

Si se pasa una cadena vacía como hostNameOrAddress argumento, este método devuelve las direcciones IPv4 e IPv6 del host local.

Las direcciones IPv6 se filtran de los resultados del GetHostAddresses método si el equipo local no tiene instalado IPv6. Como resultado, es posible recuperar una instancia vacía IPAddress si solo había resultados IPv6 disponibles para el hostNameOrAddress parámetro .

Este método se implementa mediante las API de resolución de nombres del sistema operativo subyacente (como getaddrinfo de la API win32 en Windows y las API equivalentes en otras plataformas). Si se describe un host en el hosts archivo, se devolverá la dirección IP o las direcciones sin consultar el servidor DNS.