statusCode, propriété de Sys.Net.XmlHttpExecutor
Mise à jour : novembre 2007
Obtient le code d'état de l'objet XMLHTTP du navigateur.
.gif "Remarque") 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 statusCode = MyExecutor.get_statusCode();
Exceptions
Type d'exception |
Condition |
|---|---|
L'accès à la propriété statusCode s'est effectué en dehors du gestionnaire d'événements. - ou - L'accès à la propriété statusCode s'est effectué après que l'événement terminé s'est produit. |
Valeur de retour
Code 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
Vous pouvez utiliser la propriété statusCode 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é statusCode lorsque l'exécuteur s'est terminé sur un échec, ou si la propriété responseAvailable retourne la valeur false. Une exception est également levée si vous utilisez la propriété statusCode après que l'événement terminé s'est produit. Ceci se produit parce que l'exécuteur a libéré sa référence vers l'objet XMLHTTP du navigateur.
Exemple
L'exemple suivant indique comment accéder aux informations d'état à l'aide de la propriété statusCode. Ce code fait partie d'un exemple complet trouvé 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