Dns.GetHostAddresses Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.NameResolution.dll

Sobrecargas

GetHostAddresses(String)	Devuelve las direcciones del protocolo Internet (IP) para el host especificado.
GetHostAddresses(String, AddressFamily)	Devuelve las direcciones del protocolo Internet (IP) para el host especificado.

GetHostAddresses(String)

Source:

Dns.cs

Devuelve las direcciones del protocolo Internet (IP) para el 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

Nombre de host o dirección IP que se va a resolver.

Devoluciones

IPAddress[]

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

Excepciones

ArgumentNullException

hostNameOrAddress es null.

ArgumentOutOfRangeException

La longitud de hostNameOrAddress es mayor que 255 caracteres.

SocketException

Se detectó un error al resolver hostNameOrAddress.

ArgumentException

hostNameOrAddress no es una dirección IP válida.

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.

Nota

Este miembro emite información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, vea Seguimiento de red en .NET Framework.

GetHostAddresses(String, AddressFamily)

Source:

Dns.cs

Devuelve las direcciones del protocolo Internet (IP) para el 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

Nombre de host o dirección IP que se va a resolver.

family

AddressFamily

Familia de direcciones para la que se deben recuperar las direcciones IP. Si Unspecifiedes , recupere todas las direcciones IP independientemente de la familia de direcciones.

Devoluciones

IPAddress[]

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