Sys.Net.XmlHttpExecutor responseData 属性

更新：2007 年 11 月

获取响应正文的文本表示形式。

说明：
若要获取或设置客户端 API 属性的属性值，必须调用以 get_ 和 set_ 为名称前缀的属性访问器方法。例如，若要获取或设置属性 cancel 的值，需要调用 get_cancel 或 set_cancel 方法。

var responseData = MyExecutor.get_responseData();

异常

返回值

如果响应正文的文本表示形式存在，则为该文本表示形式；否则为空字符串 ("")。

备注

如果 Web 请求成功完成，则可获取 responseData 属性的值，以获得响应正文的文本表示形式。如果没有响应正文，则此属性返回空字符串 ("")。

执行器不尝试对响应数据进行任何字符转换，而是依赖于浏览器针对 Unicode 转换行为的 XMLHTTP 实现。对于 Microsoft Internet Explorer，响应作为 UTF-8 文本返回，除非服务器在响应的开头部分包含了一个字节顺序标记 (BOM) 来指示 Unicode 的其他变形。

只能在运行于 completed 事件处理程序内的代码中，或者运行于 completed 事件处理程序的调用堆栈内的代码中使用 responseData 属性。如果执行器未返回有效的响应数据，或者响应尚不可用（如果 responseAvailable 属性返回 false），则使用 responseData属性会引发异常。如果在 completed 事件已发生之后使用 responseData属性，则也会引发异常。这是因为执行器已经释放了其对浏览器的 XMLHTTP 对象的引用。

示例

下面的示例演示如何使用 responseData属性。此代码摘自 Sys.Net.XmlHttpExecutor 类概述中的一个完整示例。

// Display Web request body.
resultElementId.innerHTML += "Body: <br/>";
resultElementId.innerText += 
    executor.get_responseData();

请参见

参考

Sys.Net.WebRequestManager 类

Sys.Net.WebRequestExecutor 类

Sys.Net.XMLHttpExecutor 类