다음을 통해 공유

Dns.GetHostEntryAsync 메서드

정의

네임스페이스:
System.Net
어셈블리:
netstandard.dll, System.Net.NameResolution.dll
어셈블리:
System.Net.NameResolution.dll
어셈블리:
System.dll
어셈블리:
netstandard.dll

호스트 이름 또는 IP 주소를 IPHostEntry 비동기 작업으로 인스턴스로 확인합니다.

오버로드

Name Description
GetHostEntryAsync(IPAddress)

인스턴스에 대한 IPHostEntry IP 주소를 비동기 작업으로 확인합니다.
GetHostEntryAsync(String)

호스트 이름 또는 IP 주소를 IPHostEntry 비동기 작업으로 인스턴스로 확인합니다.
GetHostEntryAsync(String, CancellationToken)

호스트 이름 또는 IP 주소를 IPHostEntry 비동기 작업으로 인스턴스로 확인합니다.
GetHostEntryAsync(String, AddressFamily, CancellationToken)

호스트 이름 또는 IP 주소를 IPHostEntry 비동기 작업으로 인스턴스로 확인합니다.

GetHostEntryAsync(IPAddress)

Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs

인스턴스에 대한 IPHostEntry IP 주소를 비동기 작업으로 확인합니다.

public:
 static System::Threading::Tasks::Task<System::Net::IPHostEntry ^> ^ GetHostEntryAsync(System::Net::IPAddress ^ address);
public static System.Threading.Tasks.Task<System.Net.IPHostEntry> GetHostEntryAsync(System.Net.IPAddress address);
static member GetHostEntryAsync : System.Net.IPAddress -> System.Threading.Tasks.Task<System.Net.IPHostEntry>
Public Shared Function GetHostEntryAsync (address As IPAddress) As Task(Of IPHostEntry)

매개 변수

address
IPAddress

IP 주소입니다.

반환

Task<IPHostEntry>

비동기 작업을 나타내는 작업 개체입니다. 작업 개체의 속성은 Result 지정된 호스트address에 대한 주소 정보를 포함하는 인스턴스를 반환 IPHostEntry 합니다.

예외

ArgumentNullException

address은 null입니다.

SocketException

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

ArgumentException

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

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 확인된 후에 address 완료됩니다.

이 메서드는 IP 주소와 연결된 IP 주소 및 별칭에 대한 DNS 서버를 쿼리합니다.

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

반환된 인스턴스의 IPHostEntry 속성은 Aliases 이 메서드로 채워지지 않으며 항상 비어 있습니다.

메모

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

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 GetHostEntry(IPAddress)throw된 예외를 참조하세요.

적용 대상

GetHostEntryAsync(String)

Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs

호스트 이름 또는 IP 주소를 IPHostEntry 비동기 작업으로 인스턴스로 확인합니다.

public:
 static System::Threading::Tasks::Task<System::Net::IPHostEntry ^> ^ GetHostEntryAsync(System::String ^ hostNameOrAddress);
public static System.Threading.Tasks.Task<System.Net.IPHostEntry> GetHostEntryAsync(string hostNameOrAddress);
static member GetHostEntryAsync : string -> System.Threading.Tasks.Task<System.Net.IPHostEntry>
Public Shared Function GetHostEntryAsync (hostNameOrAddress As String) As Task(Of IPHostEntry)

매개 변수

hostNameOrAddress
String

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

반환

Task<IPHostEntry>

비동기 작업을 나타내는 작업 개체입니다. 작업 개체의 속성은 Result 지정된 호스트hostNameOrAddress에 대한 주소 정보를 포함하는 인스턴스를 반환 IPHostEntry 합니다.

예외

ArgumentNullException

매개 변수는 hostNameOrAddress .입니다 null.

ArgumentOutOfRangeException

매개 변수 길이 hostNameOrAddress 가 255자를 초과합니다.

SocketException

매개 변수를 hostNameOrAddress 확인할 때 오류가 발생했습니다.

ArgumentException

hostNameOrAddress 매개 변수가 잘못된 IP 주소입니다.

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 확인된 후에 hostNameOrAddress 완료됩니다.

이 메서드는 호스트 이름 또는 IP 주소와 연결된 IP 주소에 대한 DNS 서버를 쿼리합니다.

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

호스트 이름을 찾을 SocketException 수 없는 경우 예외 값이 11001(Windows 소켓 오류 WSAHOST_NOT_FOUND)으로 반환됩니다. DNS 서버가 응답하지 않는 경우 이 예외를 반환할 수 있습니다. 이 예외는 이름이 공식 호스트 이름이나 별칭이 아니거나 쿼리 중인 데이터베이스에서 찾을 수 없는 경우에도 반환될 수 있습니다.

ArgumentException 매개 변수에 hostNameOrAddress 포함 Any 되거나 IPv6Any.

이 메서드는 IP 리터럴 문자열이 매개 변수에 hostNameOrAddress 전달되는 경우 애플리케이션이 모든 속성 집합과 함께 반환되는 인스턴스를 원한다고 가정합니다 IPHostEntry . 이러한 속성에는 AddressList, Aliases및 HostName. 따라서 이 메서드의 구현은 IP 문자열 리터럴이 전달될 때 다음과 같은 동작을 표시합니다.

  1. 메서드는 주소를 구문 분석하려고 시도합니다. 매개 변수에 hostNameOrAddress 법적 IP 문자열 리터럴이 포함되어 있으면 첫 번째 단계가 성공합니다.

  2. IP 문자열 리터럴의 IP 주소를 사용한 역방향 조회가 호스트 이름을 가져오려고 시도합니다. 이 결과는 속성으로 설정됩니다 HostName .

  3. 이 역방향 조회의 호스트 이름은 이름과 연결된 가능한 모든 IP 주소를 가져오고 속성으로 AddressList 설정하기 위해 다시 사용됩니다.

IPv4 문자열 리터럴의 경우 위의 세 단계가 모두 성공할 수 있습니다. 그러나 실제로 다른 호스트에 속하는 IPv4 주소에 대한 부실 DNS 레코드가 반환될 수 있습니다. 이로 인해 3단계가 실패하고 예외가 throw될 수 있습니다(IPv4 주소에 대한 DNS PTR 레코드가 있지만 IPv4 주소에 대한 DNS A 레코드는 없음).

IPv6의 경우 대부분의 IPv6 배포에서 IPv6 주소에 대한 역방향(PTR) 레코드를 등록하지 않으므로 위의 2단계가 실패할 수 있습니다. 따라서 이 메서드는 문자열 IPv6 리터럴을 속성의 FQDN(정규화된 도메인) 호스트 이름으로 반환할 HostName 수 있습니다.

이 GetHostAddresses 메서드는 IP 리터럴과 관련하여 다른 동작을 가합니다. 위의 1단계가 성공하면(IP 주소로 성공적으로 구문 분석) 해당 주소가 결과로 즉시 반환됩니다. 역방향 조회는 시도하지 않습니다.

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

반환된 인스턴스의 IPHostEntry 속성은 Aliases 이 메서드로 채워지지 않으며 항상 비어 있습니다.

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

메모

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

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 GetHostEntry(String)throw된 예외를 참조하세요.

적용 대상

GetHostEntryAsync(String, CancellationToken)

Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs

호스트 이름 또는 IP 주소를 IPHostEntry 비동기 작업으로 인스턴스로 확인합니다.

public:
 static System::Threading::Tasks::Task<System::Net::IPHostEntry ^> ^ GetHostEntryAsync(System::String ^ hostNameOrAddress, System::Threading::CancellationToken cancellationToken);
public static System.Threading.Tasks.Task<System.Net.IPHostEntry> GetHostEntryAsync(string hostNameOrAddress, System.Threading.CancellationToken cancellationToken);
static member GetHostEntryAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPHostEntry>
Public Shared Function GetHostEntryAsync (hostNameOrAddress As String, cancellationToken As CancellationToken) As Task(Of IPHostEntry)

매개 변수

hostNameOrAddress
String

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

cancellationToken
CancellationToken

비동기 작업을 알리는 데 사용할 수 있는 취소 토큰을 취소해야 합니다.

반환

Task<IPHostEntry>

비동기 작업을 나타내는 작업 개체입니다. 작업 개체의 속성은 Result 지정된 호스트hostNameOrAddress에 대한 주소 정보를 포함하는 인스턴스를 반환 IPHostEntry 합니다.

예외

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 GetHostEntry(String)throw된 예외를 참조하세요.

적용 대상

GetHostEntryAsync(String, AddressFamily, CancellationToken)

Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs
Source:
Dns.cs

호스트 이름 또는 IP 주소를 IPHostEntry 비동기 작업으로 인스턴스로 확인합니다.

public static System.Threading.Tasks.Task<System.Net.IPHostEntry> GetHostEntryAsync(string hostNameOrAddress, System.Net.Sockets.AddressFamily family, System.Threading.CancellationToken cancellationToken = default);
static member GetHostEntryAsync : string * System.Net.Sockets.AddressFamily * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPHostEntry>
Public Shared Function GetHostEntryAsync (hostNameOrAddress As String, family As AddressFamily, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPHostEntry)

매개 변수

hostNameOrAddress
String

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

family
AddressFamily

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

cancellationToken
CancellationToken

비동기 작업을 알리는 데 사용할 수 있는 취소 토큰을 취소해야 합니다.

반환

Task<IPHostEntry>

비동기 작업을 나타내는 작업 개체입니다. 작업 개체의 속성은 Result 지정된 호스트hostNameOrAddress에 대한 주소 정보를 포함하는 인스턴스를 반환 IPHostEntry 합니다.

예외

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 GetHostEntry(String, AddressFamily)throw된 예외를 참조하세요.

적용 대상