Dns.GetHostAddresses 메서드

정의

네임스페이스:

System.Net

어셈블리:

System.Net.NameResolution.dll

오버로드

GetHostAddresses(String)	지정된 호스트의 IP(인터넷 프로토콜) 주소를 반환합니다.
GetHostAddresses(String, AddressFamily)	지정된 호스트의 IP(인터넷 프로토콜) 주소를 반환합니다.

GetHostAddresses(String)

Source:

Dns.cs

지정된 호스트의 IP(인터넷 프로토콜) 주소를 반환합니다.

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 주소입니다.

반환

IPAddress[]

hostNameOrAddress 매개 변수로 지정된 호스트의 IP 주소가 포함된 IPAddress 형식의 배열입니다.

예외

ArgumentNullException

hostNameOrAddress이(가) null인 경우

ArgumentOutOfRangeException

hostNameOrAddress의 길이가 255자를 넘습니다.

SocketException

hostNameOrAddress을 확인할 때 오류가 발생한 경우

ArgumentException

hostNameOrAddress가 잘못된 IP 주소인 경우

예제

다음 코드 예제에서는 메서드를 GetHostAddresses 사용하여 IP 주소를 형식 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 호스트 이름과 연결된 IP 주소에 대한 DNS 하위 시스템을 쿼리합니다. 가 IP 주소인 경우 hostNameOrAddress 이 주소는 DNS 서버를 쿼리하지 않고 반환됩니다.

빈 문자열이 인수로 hostNameOrAddress 전달되면 이 메서드는 로컬 호스트의 IPv4 및 IPv6 주소를 반환합니다.

로컬 컴퓨터에 IPv6이 설치되어 있지 않은 경우 IPv6 주소는 메서드의 GetHostAddresses 결과에서 필터링됩니다. 따라서 매개 변수에 IPv6 결과만 사용할 수 있는 경우 빈 IPAddress 인스턴스를 hostNameOrAddress 다시 가져올 수 있습니다.

이 메서드는 기본 운영 체제의 이름 확인 API(예: Windows의 Win32 API getaddrinfo 및 다른 플랫폼의 동등한 API)를 사용하여 구현됩니다. 호스트가 파일에 설명 hosts 된 경우 DNS 서버를 쿼리하지 않고 IP 주소 또는 주소가 반환됩니다.

참고

이 멤버는 애플리케이션에서 네트워크 추적을 사용 하도록 설정 하면 추적 정보를 내보냅니다. 자세한 내용은 .NET Framework의 네트워크 추적을 참조하세요.

GetHostAddresses(String, AddressFamily)

Source:

Dns.cs

지정된 호스트의 IP(인터넷 프로토콜) 주소를 반환합니다.

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

매개 변수

hostNameOrAddress

String

확인할 호스트 이름 또는 IP 주소입니다.

family

AddressFamily

IP를 검색해야 하는 주소 패밀리입니다. 이면 Unspecified주소 패밀리에 관계없이 모든 IP를 검색합니다.

반환

IPAddress[]

hostNameOrAddress 매개 변수로 지정된 호스트의 IP 주소가 포함된 IPAddress 형식의 배열입니다.