Sys.Net.WebRequest add_completed 메서드
업데이트: 2007년 11월
웹 요청의 완료된 요청 이벤트에 대한 처리기를 등록합니다.
MyWebRequest.add_completed(handler);
인수
값 |
정의 |
|---|---|
handler |
완료된 요청 이벤트를 처리하기 위해 등록된 함수입니다. |
설명
웹 요청과 연결된 실행자는 completed 메서드를 호출하여 완료된 요청 이벤트를 발생시킵니다. 연결된 실행자에서 수행되고 있는 작업이 끝나면 반환된 데이터를 처리하기 위해 처리기 함수가 호출됩니다. 작업 완료가 성공을 나타내지는 않습니다. 실행자 작업은 완료, 중단 또는 시간 초과 상태 중 하나로 끝납니다.
등록된 이벤트 처리기 함수에는 다음과 같은 두 매개 변수를 사용해야 합니다.
네트워크 요청을 발생시킨 실행자에 대한 참조. 실행자에 액세스하여 상태를 확인하고 응답 데이터를 검색할 수 있습니다.
완료된 요청 이벤트를 발생시킨 실행자에 의해 설정되는 eventArgs 매개 변수. 기본 실행자의 경우 이 인수는 Sys.EventArgs.empty 속성으로 설정됩니다.
이벤트 처리기에서는 responseAvailable, aborted 또는 timedOut이라는 세 개의 executor 속성 중 하나를 사용하여 실행자의 상태를 결정할 수 있습니다.
이벤트 처리기에서는 responseAvailable에서 true를 반환하는 경우에만 실행자에 대한 다른 응답 정보에 액세스할 수 있습니다.
예제
다음 예제에서는 완료 이벤트 처리기를 추가하고 제거하는 방법을 보여 줍니다. 이 코드는 WebRequest 클래스 개요에서 볼 수 있는 전체 예제의 일부입니다.
// This function adds and removes the
// Web request completed event handler.
function WebRequestCompleted()
{
// Instantiate the WebRequest.
var wRequest = new Sys.Net.WebRequest();
// Set the request Url.
wRequest.set_url(getPage);
// Set the web request completed event handler,
// for processing return data.
wRequest.add_completed(OnWebRequestCompleted);
alert("Added Web request completed handler");
// Remove the web request completed event handler.
// Comment the following two lines if you want to
// use the handler.
wRequest.remove_completed(OnWebRequestCompleted);
alert("Removed handler; the Web request return is not processed.");
// Execute the request.
wRequest.invoke();
}