Dns.BeginGetHostAddresses(String, AsyncCallback, Object) 메서드

정의

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

지정된 호스트에 대한 IP(인터넷 프로토콜) 주소를 비동기적으로 반환합니다.

public:
 static IAsyncResult ^ BeginGetHostAddresses(System::String ^ hostNameOrAddress, AsyncCallback ^ requestCallback, System::Object ^ state);
public static IAsyncResult BeginGetHostAddresses(string hostNameOrAddress, AsyncCallback requestCallback, object state);
static member BeginGetHostAddresses : string * AsyncCallback * obj -> IAsyncResult
Public Shared Function BeginGetHostAddresses (hostNameOrAddress As String, requestCallback As AsyncCallback, state As Object) As IAsyncResult

매개 변수

hostNameOrAddress
String

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

requestCallback
AsyncCallback

AsyncCallback 작업이 완료되면 호출할 메서드를 참조하는 대리자입니다.

state
Object

작업에 대한 정보를 포함하는 사용자 정의 개체입니다. 작업이 완료되면 이 개체가 requestCallback 대리자에게 전달됩니다.

반품

IAsyncResult

IAsyncResult 비동기 요청을 참조하는 인스턴스입니다.

예외

ArgumentNullException

hostNameOrAddress은 null입니다.

ArgumentOutOfRangeException

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

SocketException

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

ArgumentException

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

설명

이 메서드는 BeginGetHostAddresses 호스트 이름과 연결된 IP 주소에 대해 DNS 서버를 비동기적으로 쿼리합니다. IP 주소인 경우 hostNameOrAddress 이 주소는 DNS 서버를 쿼리하지 않고 반환됩니다.

메모

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

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

메서드를 호출 BeginGetHostAddresses 하여 비동 EndGetHostAddresses 기 작업을 완료해야 합니다. 일반적으로 메서드는 대리자가 호출합니다 requestCallback .

이 메서드는 작업이 완료될 때까지 차단되지 않습니다. 작업이 완료될 때까지 차단하려면 메서드를 GetHostAddresses 사용합니다.

비동기 프로그래밍 모델을 사용하는 방법에 대한 자세한 내용은 비동기적으로 동기 메서드 호출을 참조하세요.

적용 대상