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

Mise à jour : novembre 2007

Retourne un objet XMLDOM qui contient la réponse XML 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 xml = MyExecutor.get_xml();

Exceptions

Notes

Lorsque le texte de réponse envoyé du serveur est du code XML valide, l'exécuteur peut le convertir en un objet XMLDOM. Si l'exécuteur ne peut pas convertir le texte de réponse en un objet XMLDOM, il retourne null.

Remarque :
Avec Microsoft Internet Explorer, l'exécuteur affecte explicitement au langage de sélection de l'instance XMLDOM la valeur XPath. L'objet XMLDOM retourné a le comportement de codage de caractères spécifique à l'implémentation XMLHTTP du navigateur. Cette propriété est substituée à partir de l'implémentation de la classe de base.

Vous pouvez utiliser la propriété xml 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é xml 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é xml 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 montre comment utiliser la propriété xml. Ce code fait partie d'un exemple complet disponible dans la vue d'ensemble de la classe Sys.Net.XmlHttpExecutor.

// This is the event handler called after 
// the Web request returns. It is designed
// for Web requests that return XML.
function OnSucceededXml(executor, eventArgs) 
{
    if (executor.get_responseAvailable()) 
    {
        // Display XML.
       if (document.all)
            resultElementId.innerText += executor.get_xml().xml;
        else
            // Firefox 
            resultElementId.textContent += "First node: " + 
                executor.get_xml().documentElement.nodeName;

    }
    else
    {
        if (executor.get_timedOut())
            alert("Timed Out");
        else
            if (executor.get_aborted())
                alert("Aborted");
    }
} 

Voir aussi

Référence

Sys.Net.WebRequestManager, classe

Sys.Net.WebRequestExecutor, classe

Sys.Net.XMLHttpExecutor, classe

Autres ressources

À propos du code XMLHTTP natif