DataServiceResponsePreference-Enumeration
Bestimmt, ob der Client fordert, dass die per Datendienstrückgabe eingefügten oder aktualisierten Entitätsdaten als Eintrag in der Antwortnachricht übergeben werden.
Namespace: System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Syntax
'Declaration
Public Enumeration DataServiceResponsePreference
'Usage
Dim instance As DataServiceResponsePreference
public enum DataServiceResponsePreference
public enum class DataServiceResponsePreference
type DataServiceResponsePreference
public enum DataServiceResponsePreference
Elemente
Elementname | Beschreibung | |
---|---|---|
None | Der Prefer-Header ist nicht in der Anforderung enthalten, die das Standardverhalten ist. | |
IncludeContent | Fordert, dass der Datendienst eine Kopie der eingefügten oder geänderten Entität als Eintrag im Text der Antwortnachricht zurückgibt. | |
NoContent | Fordert, dass der Datendienst keine Kopie der eingefügten oder geänderten Entität als Eintrag im Text der Antwortnachricht zurückgibt. |
Hinweise
Der Client verwendet den DataServiceResponsePreference-Wert, um zu ermitteln, ob der Prefer-Header generiert wird. Der generierte Prefer-Header wird verwendet, um auch zu bestimmen, ob die geänderte Entität von einer Einfüge- oder Aktualisierungsverarbeitung zurückgegeben wird.
Die DataServiceResponsePreference-Eigenschaft wird für HTTP POST, HTTP PUT, HTTP MERGE und HTTP-PATCH-Anforderungen verwendet. Der IncludeContent-Wert wird Client verwendet, um zu fordern, dass der Datendienst die eingefügte oder aktualisierte Entität im Text der Antwortnachricht zurückgibt. Wenn dieser Wert zur AddAndUpdateResponsePreference-Eigenschaft des Kontexts angegeben wird, schließt der Client den Rückgabeinhalt-Wert in der Anforderung in den Prefer-Header ein.
Der Client verarbeitet immer Einträge in der Antwortnachricht zu HTTP POST, HTTP MERGE- und HTTP PUT-Anforderungen, unabhängig von der Einstellung IncludeContent.
Der Prefer-Header wird in Version 3 von Open Data Protocol (OData) und der höherer Versionen unterstützt.