データ サービスが挿入または更新されたエンティティ データを応答メッセージのエントリとして返すようにクライアントが要求するかどうかを決定します。
名前空間: 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 プロパティに指定すると、クライアントは要求の Prefer ヘッダーに return-content 値を含めます。
クライアントは、IncludeContent 設定に関係なく、HTTP POST、HTTP MERGE、および HTTP PUT 要求への応答メッセージ内のエントリを常に処理します。
Prefer ヘッダーは、Open Data Protocol (OData) の Version 3 以降のバージョンでサポートされます。