Sys.Net.XmlHttpExecutor.getResponseHeader-Methode

Aktualisiert: November 2007

Ruft den Wert eines bestimmten Antwortheaders auf Grundlage des Headernamens ab.

var statusText = MyExecutor.getResponseHeader();

Ausnahmen

Ausnahmetyp

Bedingung

Sys.InvalidOperationException

Auf die getResponseHeader-Eigenschaft wurde außerhalb des Ereignishandlers zugegriffen.

- oder -

Auf die getResponseHeader-Eigenschaft wurde zugegriffen, nachdem das abgeschlossene Ereignis aufgetreten war.

Hinweise

Wenn die Webanforderung erfolgreich abgeschlossen wurde, können Sie die getResponseHeader-Methode aufrufen, um den Wert eines bestimmten Antwortheaders auf der Grundlage des Headernamens abzurufen. Wenn der Header nicht vorhanden ist, wird eine leere Zeichenfolge ("") zurückgegeben.

Die getResponseHeader-Methode kann nur in Code aufgerufen werden, der innerhalb eines abgeschlossenen Ereignishandlers bzw. in der Aufrufliste des abgeschlossenen Ereignishandlers ausgeführt wird. Wenn Sie die getResponseHeader-Methode aufrufen, während der Executor nicht erfolgreich beendet wurde oder wenn die XmlHttpExecutor.responseAvailable-Eigenschaft false zurückgibt, wird eine Ausnahme ausgelöst. Eine Ausnahme wird auch ausgelöst, wenn Sie die getResponseHeader-Methode aufrufen, nachdem das abgeschlossene Ereignis aufgetreten ist. Dies liegt daran, dass der Executor seinen Verweis auf das XMLHTTP-Objekt des Browsers freigegeben hat.

Beispiel

Im folgenden Beispiel wird das Abrufen der Headerdaten veranschaulicht. Dieser Code ist Teil eines vollständigen Beispiels, das in der Übersicht über die Sys.Net.XmlHttpExecutor-Klasse enthalten ist.

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

Siehe auch

Referenz

Sys.Net.WebRequestManager-Klasse

Sys.Net.WebRequestExecutor-Klasse

Sys.Net.XMLHttpExecutor-Klasse