Свойство Sys.Net.XmlHttpExecutor xml
Обновлен: Ноябрь 2007
Возвращает объект XMLDOM, который содержит XML-ответ от объекта обозревателя XMLHTTP.
Примечание. |
---|
Чтобы получить или задать значения свойств для клиентского интерфейса API, необходимо вызвать методы доступа к свойствам, имена которых содержат префиксы get_ и set_. Например, чтобы получить или задать значение свойства cancel, следует вызвать метод get_cancel или set_cancel соответственно. |
var xml = MyExecutor.get_xml();
Исключения
Тип исключения |
Условие |
---|---|
Обращение к свойству xml было выполнено вне обработчика событий. -либо- Обращение к свойству xml было выполнено после возникновения завершенного события. |
Заметки
Если отклик от сервера отображается в тексте допустимого XML-формата, исполнитель запросов может конвертировать его в объектXMLDOM. Если исполнителю не удается преобразовать текст в объект XMLDOM, он возвращает null.
Примечание. |
---|
Посредством Microsoft Internet Explorer исполнитель запросов явным образом устанавливает для экземпляра XMLDOM язык XPath. Кодировка знаков возвращаемого объекта XMLDOM зависит от реализации XMLHTTP обозревателя. Данное свойство переопределяется реализацией базового класса. |
Свойство xml можно использовать только в коде, который выполняется внутри обработчика завершенных событий или в стеке вызова обработчика завершенных событий. Если при использовании свойства xml исполнителю запросов не удалось выполнить операцию или метод XmlHttpExecutor.get_responseAvailable вернул значение false, вызывается исключение. Исключение вызывается также, если свойство xml используется при возникновении завершенного события. Это происходит потому, что исполнитель удалил свою ссылку на объект 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.WebRequestManager
Класс Sys.Net.WebRequestExecutor