Enumerazione DataServiceResponsePreference
Determina se il client richiede che il servizio dati restituisca i dati di entità inseriti o aggiornati come voce nel messaggio di risposta.
Spazio dei nomi System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Sintassi
'Dichiarazione
Public Enumeration DataServiceResponsePreference
'Utilizzo
Dim instance As DataServiceResponsePreference
public enum DataServiceResponsePreference
public enum class DataServiceResponsePreference
type DataServiceResponsePreference
public enum DataServiceResponsePreference
Membri
Nome membro | Descrizione | |
---|---|---|
None | L'intestazione Prefer non è inclusa nella richiesta, che è il comportamento predefinito. | |
IncludeContent | Richiede che il servizio dati restituisca una copia dell'entità inserita o modificata come voce nel corpo del messaggio di risposta. | |
NoContent | Richiede che il servizio dati non restituisca una copia dell'entità inserita o modificata come voce nel corpo del messaggio di risposta. |
Osservazioni
Il client utilizza il valore DataServiceResponsePreference per determinare se generare l'intestazione Prefer. Quando viene generata l'intestazione Prefer, questo valore viene utilizzato anche per determinare se richiedere che venga restituita l'entità modificata in seguito a un'operazione di inserimento o di aggiornamento.
La proprietà DataServiceResponsePreference viene utilizzata per richieste HTTP POST, HTTP PUT, HTTP MERGE e HTTP PATCH. Il valore IncludeContent viene utilizzato dal client per richiedere che il servizio dati restituisca l'entità inserita o aggiornata nel corpo del messaggio di risposta. Quando questo valore viene fornito alla proprietà AddAndUpdateResponsePreference del contesto, il client include il valore return-content nell'intestazione Prefer della richiesta.
Il client elabora sempre le voci nel messaggio di risposta alle richieste HTTP POST, HTTP MERGE e HTTP PUT, indipendentemente dall'impostazione IncludeContent.
L'intestazione Prefer è supportata nella versione 3 di OData (Open Data Protocol) e nelle versioni successive.