Dns.GetHostAddresses 메서드

정의

네임스페이스:: System.Net

어셈블리:: netstandard.dll, System.Net.NameResolution.dll

어셈블리:: System.Net.NameResolution.dll

어셈블리:: System.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

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

GetHostAddresses(String)

Source:: Dns.cs

Source:: Dns.cs

Source:: Dns.cs

Source:: Dns.cs

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[]

매개 변수로 지정된 호스트의 IP 주소를 보유하는 형식 IPAddress 의 hostNameOrAddress 배열입니다.

예외

ArgumentNullException

hostNameOrAddress은 null입니다.

ArgumentOutOfRangeException

길이 hostNameOrAddress 가 255자를 초과합니다.

SocketException

를 확인할 때 오류가 발생합니다 hostNameOrAddress.

ArgumentException

hostNameOrAddress 가 잘못된 IP 주소입니다.

예제

다음 코드 예제에서는 메서드를 GetHostAddresses 사용 하 여 형식 IPAddress의 배열에 IP 주소를 확인 합니다.

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의Network 추적 참조하세요.

적용 대상

GetHostAddresses(String, AddressFamily)

Source:: Dns.cs

Source:: Dns.cs

Source:: Dns.cs

Source:: Dns.cs

Source:: Dns.cs