Перечисление DataServiceResponsePreference
Определяет, возвращают ли запросы клиентов к службе данных вставленные или обновленные данные сущностей в виде записи в ответном сообщении.
Пространство имен: System.Data.Services.Client
Сборка: Microsoft.Data.Services.Client (в Microsoft.Data.Services.Client.dll)
Синтаксис
'Декларация
Public Enumeration DataServiceResponsePreference
'Применение
Dim instance As DataServiceResponsePreference
public enum DataServiceResponsePreference
public enum class DataServiceResponsePreference
type DataServiceResponsePreference
public enum DataServiceResponsePreference
Элементы
Имя элемента | Описание | |
---|---|---|
None | Заголовок Prefer не включен в запрос, который является поведением по умолчанию. | |
IncludeContent | Запросы, в ответ на которые служба данных возвращает копию вставленных или измененных сущностей в виде записи в тексте ответного сообщения. | |
NoContent | Запрос, в ответ на который служба данных не возвращает копию вставленных или измененных сущностей в виде записи в тексте ответного сообщения. |
Замечания
Клиент использует значение DataServiceResponsePreference, чтобы определить, следует ли создавать заголовок Prefer. При создании заголовка Prefer это значение также используется для определения необходимости запросить возврат измененной сущности из операции вставки или обновления.
Свойство DataServiceResponsePreference используется для запросов HTTP POST, HTTP PUT, HTTP MERGE и HTTP PATCH. Значение IncludeContent используется клиентом для запроса к службе данных, который возвращает вставленную или обновленную сущность в тексте ответного сообщения. Когда это значение передается в свойство AddAndUpdateResponsePreference контекста, клиент содержит значение return-content в заголовке Prefer запроса.
Клиент всегда обрабатывает записи в ответном сообщении HTTP POST, HTTP MERGE и HTTP PUT вне зависимости от параметра IncludeContent.
Заголовок Prefer поддерживается в версии 3 Протокол Open Data Protocol (OData) и в более поздних версиях.