Sys.Net.XmlHttpExecutor xml 속성
업데이트: 2007년 11월
브라우저의 XMLHTTP 개체에서 XML 응답을 포함하는 XMLDOM 개체를 반환합니다.
참고
클라이언트 API 속성에 대한 속성 값을 가져오거나 설정하려면 이름에 get_ 및 set_ 접두사가 붙은 속성 접근자 메서드를 호출해야 합니다. 예를 들어 cancel과 같은 속성의 값을 가져오거나 설정하려면 get_cancel 또는 set_cancel 메서드를 호출합니다.
var xml = MyExecutor.get_xml();
예외
예외 형식 |
조건 |
|---|---|
이벤트 처리기 외부에서 xml 속성에 액세스한 경우 - 또는 - 완료 이벤트가 발생한 후 xml 속성에 액세스한 경우 |
설명
서버에서 보낸 응답 텍스트가 올바른 XML인 경우 실행자는 이 XML을 XMLDOM 개체로 변환할 수 있습니다. 실행자가 응답 텍스트를 XMLDOM 개체로 변환할 수 없는 경우에는 null을 반환합니다.
참고
Microsoft Internet Explorer를 사용하는 경우 실행자는 XMLDOM 인스턴스의 선택 언어를 명시적으로 XPath로 설정합니다. 반환되는 XMLDOM 개체에는 브라우저의 XMLHTTP 구현에 따라 다른 문자 인코딩 동작이 포함됩니다. 이 속성은 기본 클래스 구현에서 재정의됩니다.
완료 이벤트 처리기 내에서 실행 중이거나 완료 이벤트 처리기의 호출 스택에서 실행 중인 코드에서만 xml 속성을 사용할 수 있습니다. 실행자가 반환되지 않은 경우 xml속성을 사용하거나, XmlHttpExecutor.get_responseAvailable 메서드에서 false를 반환하면 예외가 throw됩니다. 완료 이벤트가 발생한 후에 xml 속성을 사용해도 예외가 throw됩니다. 이는 실행자가 브라우저의 XMLHTTP 개체에 대한 참조를 해제했기 때문입니다.
예제
다음 예제에서는 xml 속성을 사용하는 방법을 보여 줍니다. 이 코드는 Sys.Net.XmlHttpExecutor 클래스 개요에서 볼 수 있는 전체 예제의 일부입니다.
// This is the event handler called after
// the Web request returns. It is designed
// for Web requests that return XML.
function OnSucceededXml(executor, eventArgs)
{
if (executor.get_responseAvailable())
{
// Display XML.
if (document.all)
resultElementId.innerText += executor.get_xml().xml;
else
// Firefox
resultElementId.textContent += "First node: " +
executor.get_xml().documentElement.nodeName;
}
else
{
if (executor.get_timedOut())
alert("Timed Out");
else
if (executor.get_aborted())
alert("Aborted");
}
}
참고 항목
참조
Sys.Net.WebRequestExecutor 클래스