Partager via


Sys.Net.XmlHttpExecutor.getResponseHeader, méthode

Mise à jour : novembre 2007

Obtient la valeur d'un en-tête de réponse spécifié en fonction du nom de l'en-tête.

var statusText = MyExecutor.getResponseHeader();

Exceptions

Type d'exception

Condition

Sys.InvalidOperationException

L'accès à la propriété getResponseHeader s'est effectué en dehors du gestionnaire d'événements.

- ou -

L'accès à la propriété getResponseHeader s'est effectué après que l'événement terminé s'est produit.

Notes

Si la requête Web s'est correctement réalisée, vous pouvez appeler la méthode getResponseHeader pour obtenir la valeur d'un en-tête de réponse spécifique en fonction du nom de l'en-tête. Si l'en-tête n'existe pas, une chaîne vide ("") est retournée.

Vous pouvez appeler la méthode getResponseHeader 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 appelez la méthode getResponseHeader lorsque l'exécuteur s'est terminé sur un échec ou si la propriété XmlHttpExecutor.get_responseAvailable retourne la valeur false. Une exception est également levée si vous appelez la méthode getResponseHeader après que l'événement terminé s'est produit. Cela s'explique parle fait que l'exécuteur libère sa référence vers l'objet XMLHTTP du navigateur.

Exemple

L'exemple suivant montre comment obtenir des données d'en-tête. Ce code fait partie d'un exemple complet fourni dans la vue d'ensemble de la classe Sys.Net.XmlHttpExecutor.

// Get a specific header.
resultElementId.innerHTML += 
"Content-Type Header: " +
    executor.getResponseHeader("Content-Type") + 
    "<br/>";       

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe