Поделиться через


Свойство Sys.Net.XmlHttpExecutor xml

Обновлен: Ноябрь 2007

Возвращает объект XMLDOM, который содержит XML-ответ от объекта обозревателя XMLHTTP.

Bb397569.alert_note(ru-ru,VS.90).gifПримечание.

Чтобы получить или задать значения свойств для клиентского интерфейса API, необходимо вызвать методы доступа к свойствам, имена которых содержат префиксы get_ и set_. Например, чтобы получить или задать значение свойства cancel, следует вызвать метод get_cancel или set_cancel соответственно.

var xml = MyExecutor.get_xml();

Исключения

Тип исключения

Условие

Sys.InvalidOperationException

Обращение к свойству xml было выполнено вне обработчика событий.

-либо-

Обращение к свойству xml было выполнено после возникновения завершенного события.

Заметки

Если отклик от сервера отображается в тексте допустимого XML-формата, исполнитель запросов может конвертировать его в объектXMLDOM. Если исполнителю не удается преобразовать текст в объект XMLDOM, он возвращает null.

Bb397569.alert_note(ru-ru,VS.90).gifПримечание.

Посредством 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

Класс Sys.Net.XMLHttpExecutor

Другие ресурсы

О собственном XMLHTTP