Sys.Net.XmlHttpExecutor statusText 属性

更新:2007 年 11 月

获取浏览器的 XMLHTTP 对象的状态文本。

说明:

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

var statusText = MyExecutor.get_statusText();

异常

异常类型

条件

Sys.InvalidOperationException

在事件处理程序之外访问了 statusText 属性。

- 或 -

在完成事件发生之后访问了 statusText 属性。

返回值

浏览器的 XMLHTTP 对象的字符串形式的状态文本(例如,“200 OK The request has succeeded.”)。有关更多信息,请参见 About Native XMLHTTP(关于本机 XMLHTTP)。

备注

如果请求成功完成,则可获取 statusText 属性的值,以及浏览器的 XMLHTTP 对象的状态文本。

只有在运行于完成事件处理程序内的代码中,或者在运行于完成事件处理程序的调用堆栈内的代码中,才能使用 statusText 属性。如果在执行器未成功返回,或者 XmlHttpExecutor.get_responseAvailable 方法返回 false 时使用 statusText 属性,则会引发异常。如果在完成事件发生之后使用 statusText 属性,也会引发异常。这是因为执行器已经释放了其对浏览器的 XMLHTTP 对象的引用。

示例

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

// Display the Web request status. 
resultElementId.innerHTML +=
   "Request Status: [" + executor.get_statusCode() + " " + 
             executor.get_statusText() + "]" + "<br/>";

请参见

参考

Sys.Net.WebRequestManager 类

Sys.Net.WebRequestExecutor 类

Sys.Net.XMLHttpExecutor 类