Sys.Net.XmlHttpExecutor xml-Eigenschaft
Aktualisiert: November 2007
Gibt ein XMLDOM-Objekt zurück, das die XML-Antwort vom XMLHTTP-Objekt des Browsers enthält.
Tipp
Um Eigenschaftenwerte für Client-API-Eigenschaften abzurufen oder festzulegen, müssen Sie Accessormethoden für die Eigenschaften aufrufen, die mit dem Präfix get_ bzw. set_ benannt sind. Beispiel: Um einen Wert für eine Eigenschaft wie cancel abzurufen oder festzulegen, rufen Sie die get_cancel-Methode oder die set_cancel-Methode auf.
var xml = MyExecutor.get_xml();
Ausnahmen
Ausnahmetyp |
Bedingung |
---|---|
Auf die xml-Eigenschaft wurde außerhalb des Ereignishandlers zugegriffen. - oder - Auf die xml-Eigenschaft wurde zugegriffen, nachdem das abgeschlossene Ereignis aufgetreten war. |
Hinweise
Wenn der vom Server gesendete Antworttext gültige XML darstellt, kann diese vom Executor in ein XMLDOM-Objekt konvertiert werden. Wenn der Executor den Antworttext nicht in ein XMLDOM-Objekt konvertieren kann, wird null zurückgegeben.
Tipp
Bei Microsoft Internet Explorer legt der Executor die Auswahlsprache der XMLDOM-Instanz explizit auf XPath fest. Das zurückgegebene XMLDOM-Objekt weist das spezifische Zeichencodierungsverhalten der XMLHTTP-Implementierung des Browsers auf. Diese Eigenschaft wird von der Basisklassenimplementierung überschrieben.
Die xml-Eigenschaft kann nur in Code verwendet werden, der innerhalb eines abgeschlossenen Ereignishandlers bzw. in der Aufrufliste des abgeschlossenen Ereignishandlers ausgeführt wird. Wenn Sie die xml-Eigenschaft verwenden, während der Executor nicht erfolgreich beendet wurde oder die XmlHttpExecutor.get_responseAvailable-Methode false zurückgibt, wird eine Ausnahme ausgelöst. Eine Ausnahme wird auch ausgelöst, wenn Sie die xml-Eigenschaft verwenden, nachdem das abgeschlossene Ereignis aufgetreten ist. Das liegt daran, dass der Executor seinen Verweis auf das XMLHTTP-Objekt des Browsers freigegeben hat.
Beispiel
Im folgenden Beispiel wird die Verwendung der xml-Eigenschaft veranschaulicht. Dieser Code ist Teil eines vollständigen Beispiels, das in der Übersicht über die Sys.Net.XmlHttpExecutor-Klasse enthalten ist.
// 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");
}
}
Siehe auch
Referenz
Sys.Net.WebRequestManager-Klasse
Sys.Net.WebRequestExecutor-Klasse
Sys.Net.XMLHttpExecutor-Klasse