Allgemeine HTTP-Anforderungen (ADO.NET Data Services-Framework)
Die Angaben in diesem Abschnitt gelten für Daten, die in allen von ADO.NET Data Services unterstützten Formaten übertragen werden.
Das für von einem Client an ADO.NET Data Services gesendete Anforderungen verwendete Serialisierungsformat wird vom HTTP-Header ContentType der Anforderung angegeben. Das Format einer Antwort von einem Datendienst wird vom HTTP-Header Accept der Anforderung angegeben. Wie in RFC 2616 festgelegt, weist der Header Accept darauf hin, dass die Anforderung auf bestimmte MIME-Typen beschränkt ist.
Verarbeitung von ACCEPT-Headern
Folgende Regeln werden in ADO.NET Data Services verwendet, um das Antwortformat zu ermitteln:
Wenn die Anforderung einen
Accept-Header enthält, wird dieser mithilfe der in Abschnit 14.1 von RFC 2616 definierten Regeln analysiert.In ADO.NET Data Services werden alle im Header festgelegten Regeln für "q"-Werte ignoriert.
Der bei der Analyse des
Accept-Headers zurückgegebene MIME-Typ wird anschließend entsprechend der unten aufgeführten Tabellen als Antwortformat verwendet.
Wenn das Format "MIME-Typ" anhand der Verarbeitungsregeln für den Accept-Header ermittelt wurde, wird der jeweilige MIME-Typ der Antwort mithilfe der in den folgenden Tabellen zusammengefassten Regeln gefunden.
Der in einem Accept-Header definierte MIME-Typ selbst bestimmt möglicherweise keinen einzelnen MIME-Typen. So definiert beispielsweise application/* keinen einzelnen Untertyp. Wenn der Server keine Antwort senden kann, die für den Accept-Headerwert zulässig ist, sendet der Server gemäß RFC 2616 den Antwortcode 406, der darauf hinweist, dass die Anforderung nicht zulässig ist.
Gruppieren von Medientypen
| Angeforderter MIME-Typ | MIME-Typ der Antwort | Serialisierungsformat |
|---|---|---|
*/* |
application/atom+xml |
ATOM/APP |
text/* |
Nicht unterstützt |
Nicht unterstützt |
application/* |
Nicht unterstützt |
Nicht unterstützt |
Einzelne Medientypen
| Angeforderter MIME-Typ | MIME-Typ der Antwort | Serialisierungsformat |
|---|---|---|
text/xml |
text/xml |
ATOM/APP |
application/xml |
application/xml |
ATOM/APP |
application/atom+xml |
application/atom+xml |
ATOM/APP |
application/json |
application/json |
JSON |
Antwortcodes
In der folgenden Tabelle sind die Antwortcodes aufgeführt, die verwendet werden, wenn eine Anforderung in ADO.NET Data Services nicht verarbeitet werden kann:
| Antwortcode | Beschreibung |
|---|---|
400 – Bad Request |
Die in einer Anforderung bereitgestellte Nutzlast ist gemäß den in dieser Spezifikation definierten Serialisierungsregeln falsch formatiert. |
404 – Not Found |
Eine Anforderung, die eines der vom Datendienst unterstützten HTTP-Verben verwendet, wird an einen URI gesendet, der keiner adressierbaren Ressource zugeordnet ist. |
406 – Not Acceptable |
Der Server kann keine für den |
422 - UnProcessable Entity |
Das Ausführen einer HTTP-Anforderung, bei der der Zustand einer ADO.NET Data Services-Ressource geändert werden soll, führt zu einer Verletzung des ADO.NET Data Services-Schemas, das anhand der Regeln unter PUT, POST und DELETE (ADO.NET Data Services-Framework) definiert ist. |
405 – Method Not Supported |
Eine an den ADO.NET Data Services-URI gesendete Anforderung verwendet eine Methode, die von der vom URI identifizierten Ressource nicht unterstützt wird. |
500 – Internal Server response code |
Beim Ausführen einer HTTP-Anforderung ist ein unerwarteter Fehler aufgetreten. |
Siehe auch
Konzepte
URI-Format für Adressressourcen (ADO.NET Data Services-Framework)
ADO.NET Data Service-Spezifikationen