Dns.GetHostAddresses(String) 메서드

정의

지정된 호스트의 IP(인터넷 프로토콜) 주소를 반환합니다.Returns the Internet Protocol (IP) addresses for the specified host.

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()

매개 변수

hostNameOrAddress
String

확인할 호스트 이름 또는 IP 주소입니다.The host name or IP address to resolve.

반환

hostNameOrAddress 매개 변수로 지정된 호스트의 IP 주소가 포함된 IPAddress 형식의 배열입니다.An array of type IPAddress that holds the IP addresses for the host that is specified by the hostNameOrAddress parameter.

예외

hostNameOrAddressnull입니다.hostNameOrAddress is null.

hostNameOrAddress의 길이가 255자를 넘습니다.The length of hostNameOrAddress is greater than 255 characters.

hostNameOrAddress을 확인할 때 오류가 발생한 경우An error is encountered when resolving hostNameOrAddress.

hostNameOrAddress가 잘못된 IP 주소인 경우hostNameOrAddress is an invalid IP address.

예제

다음 코드 예제에서는 GetHostAddresses 메서드를 사용 하 여 IPAddress형식의 배열에 대 한 IP 주소를 확인 합니다.The following code example uses the GetHostAddresses method to resolve an IP address to an array of type 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

설명

GetHostAddresses 메서드는 DNS 하위 시스템에 호스트 이름과 연결 된 IP 주소를 쿼리 합니다.The GetHostAddresses method queries the DNS subsystem for the IP addresses associated with a host name. hostNameOrAddress IP 주소인 경우 DNS 서버를 쿼리하지 않고이 주소가 반환 됩니다.If hostNameOrAddress is an IP address, this address is returned without querying the DNS server.

빈 문자열이 hostNameOrAddress 인수로 전달 되는 경우이 메서드는 로컬 호스트의 IPv4 및 IPv6 주소를 반환 합니다.If an empty string is passed as the hostNameOrAddress argument, then this method returns the IPv4 and IPv6 addresses of the local host.

IPv6 주소는 로컬 컴퓨터에 i p v 6이 설치 되어 있지 않은 경우 GetHostAddresses 방법의 결과에서 필터링 됩니다.IPv6 addresses are filtered from the results of the GetHostAddresses method if the local computer does not have IPv6 installed. 따라서 hostNameOrAddress 매개 변수에 IPv6 결과만 사용할 수 있는 경우 빈 IPAddress 인스턴스를 다시 가져올 수 있습니다.As a result, it is possible to get back an empty IPAddress instance if only IPv6 results were available for the hostNameOrAddress parameter.

이 메서드는 기본 운영 체제의 이름 확인 Api (예: Windows의 Win32 API getaddrinfo 및 다른 플랫폼의 해당 Api)를 사용 하 여 구현 됩니다.This method is implemented using the underlying operating system's name resolution APIs (such as the Win32 API getaddrinfo on Windows, and equivalent APIs on other platforms). hosts 파일에 호스트를 설명 하는 경우 DNS 서버를 쿼리하지 않고 IP 주소 또는 주소가 반환 됩니다.If a host is described in the hosts file, the IP address or addresses there will be returned without querying the DNS server.

참고

이 멤버는 애플리케이션에서 네트워크 추적을 사용 하도록 설정 하면 추적 정보를 내보냅니다.This member emits trace information when you enable network tracing in your application. 자세한 내용은 .NET Framework의 네트워크 추적합니다.For more information, see Network Tracing in the .NET Framework.

보안

DnsPermission
DNS 정보에 액세스 합니다.for accessing DNS information. 연결 된 열거형: UnrestrictedAssociated enumeration: Unrestricted

적용 대상