Dns.GetHostAddresses Método

Source:

Dns.cs

Source:

Dns.cs

Source:

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

Devoluciones

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

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.

    // 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

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 IPv6 instalado. Como resultado, es posible recuperar una instancia vacía IPAddress si solo los resultados de IPv6 estaban 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.

Source:

Dns.cs

Source:

Dns.cs

Source:

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

Devoluciones

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