更新:2007 年 11 月
返回一个 XMLDOM 对象,该对象包含浏览器的 XMLHTTP 对象的 XML 响应。
说明: |
|---|
若要获取或设置客户端 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 属性。如果在执行器未成功返回或者 XmlHttpExecutor.get_responseAvailable 方法返回 false 时使用 xml 属性,则会引发异常。如果在已完成事件发生之后使用 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");
}
}
说明: