System.Net.Dns.GetHostAddresses Method

Returns the Internet Protocol (IP) addresses for the specified host.

Syntax

public static IPAddress[] GetHostAddresses (string hostNameOrAddress)

Parameters

hostNameOrAddress
The host name or IP address to resolve.

Returns

An array of type System.Net.IPAddress that holds the IP addresses for the host that is specified by the hostNameOrAddress parameter.

Remarks

The Dns.GetHostAddresses(string) method queries a DNS server for the IP addresses associated with a host name. If hostNameOrAddress is an IP address, this address is returned without querying the DNS server.

When an empty string is passed as the host name, this method returns the IPv4 addresses of the local host for all operating systems except Windows Server 2003; for Windows Server 2003, both IPv4 and IPv6 addresses for the local host are returned.

IPv6 addresses are filtered from the results of the Dns.GetHostAddresses(string) method if the local computer does not have IPv6 installed. As a result, it is possible to get back an empty System.Net.IPAddress instance if only IPv6 results where available for the hostNameOrAddress.parameter.

Note:

This member emits trace information when you enable network tracing in your application. For more information, see Network Tracing.

Requirements

Namespace: System.Net
Assembly: System (in System.dll)
Assembly Versions: 2.0.0.0, 4.0.0.0