statusText, propriété de Sys.Net.XmlHttpExecutor

Mise à jour : novembre 2007

Obtient le texte d'état de l'objet XMLHTTP du navigateur.

Remarque :
Pour obtenir ou définir des valeurs de propriété pour les propriétés API clientes, vous devez appeler des méthodes d'accesseur de propriété dont le nom contient les préfixes get_ et set_. Par exemple, pour obtenir ou définir une valeur pour une propriété telle que cancel, vous appelez les méthodes get_cancel ou set_cancel.

var statusText = MyExecutor.get_statusText();

Exceptions

Valeur de retour

Texte d'état de l'objet XMLHTTP du navigateur sous forme de chaîne (par exemple, "200 OK. La requête a réussi".). Pour plus d'informations, consultez About Native XMLHTTP.

Notes

Si la requête s'est effectuée correctement, vous pouvez obtenir la valeur de la propriété statusText pour obtenir le texte d'état de l'objet XMLHTTP du navigateur.

Vous pouvez utiliser la propriété statusText uniquement dans du code qui s'exécute à l'intérieur d'un gestionnaire d'événements terminés ou dans la pile des appels du gestionnaire d'événements terminés. Une exception est levée si vous utilisez la propriété statusText lorsque l'exécuteur s'est terminé sur un échec, ou si la méthode XmlHttpExecutor.get_responseAvailable retourne la valeur false. Une exception est également levée si vous utilisez la propriété statusText après que l'événement terminé s'est produit. Cela est dû au fait que l'exécuteur a libéré sa référence vers l'objet XMLHTTP du navigateur.

Exemple

L'exemple suivant illustre l'utilisation de la propriété statusText. Ce code fait partie d'un exemple complet disponible dans la vue d'ensemble de la classe Sys.Net.XmlHttpExecutor.

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

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe