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

정의

네임스페이스:

System.Net

어셈블리:

System.Net.NameResolution.dll

Source:

Dns.cs

지정된 호스트의 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의 네트워크 추적을 참조하세요.

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

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

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

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