データ サービスの構成 (WCF Data Services)

WCF Data Services では、Open Data Protocol (OData) フィードを公開するデータ サービスを作成できます。 これらのフィードには、さまざまなデータ ソースからのデータが含まれることがあります。 WCF Data Services は、データ プロバイダーを使用して、このデータを OData フィードとして公開します。 これらのプロバイダーには、Entity Framework プロバイダー、リフレクション プロバイダー、およびカスタム データ サービス プロバイダー インターフェイスのセットがあります。 プロバイダーの実装は、サービスのデータ モデルを定義します。 詳細については、「データ サービス プロバイダー (WCF Data Services)」を参照してください。

WCF Data Services では、データ サービスは、データ サービスの種類がデータ モデルのエンティティ コンテナーである DataService<T> クラスから継承するクラスです。 このエンティティ コンテナーには、データ モデルのエンティティ セットにアクセスするために使用される IQueryable<T> を返す 1 つ以上のプロパティがあります。

データ サービスの動作は、DataServiceConfiguration クラスのメンバー、および DataServiceConfiguration クラスの DataServiceBehavior プロパティからアクセスされる DataServiceBehavior クラスのメンバーによって定義されます。 DataServiceConfiguration クラスは、クイックスタートで作成する Northwind サービスのようなデータ サービスによって実装される InitializeService メソッドに提供されます。

Public Class Northwind
    Inherits DataService(Of NorthwindEntities)

    ' This method is called only once to initialize service-wide policies.
    Public Shared Sub InitializeService(ByVal config As DataServiceConfiguration)
        ' Grant only the rights needed to support the client application.
        config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead _
             Or EntitySetRights.WriteMerge _
             Or EntitySetRights.WriteReplace)
        config.SetEntitySetAccessRule("Order_Details", EntitySetRights.AllRead _
            Or EntitySetRights.AllWrite)
        config.SetEntitySetAccessRule("Customers", EntitySetRights.AllRead)
    End Sub
End Class

public class Northwind : DataService<NorthwindEntities>
{
    // This method is called only once to initialize service-wide policies.
    public static void InitializeService(DataServiceConfiguration config)
    {
        // Grant only the rights needed to support the client application.
        config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead
             | EntitySetRights.WriteMerge
             | EntitySetRights.WriteReplace);
        config.SetEntitySetAccessRule("Order_Details", EntitySetRights.AllRead
            | EntitySetRights.AllWrite);
        config.SetEntitySetAccessRule("Customers", EntitySetRights.AllRead);
        config.DataServiceBehavior.MaxProtocolVersion =
            System.Data.Services.Common.DataServiceProtocolVersion.V3;
    }
}

データ サービス構成設定

DataServiceConfiguration クラスでは、以下のデータ サービスの動作を指定できます。

最小限のリソース アクセス要件

次の表に、特定の操作を実行するために付与されている必要があるエンティティ セットの最小限の権限を示します。 パスの例は、クイック スタートの完了時に作成される Northwind データ サービスに基づいています。 EntitySetRights 列挙体および ServiceOperationRights 列挙体は FlagsAttribute を使用して定義されているので、論理和演算子を使用して 1 つのエンティティ セットまたは操作に複数のアクセス許可を指定できます。 詳細については、「方法: データ サービスへのアクセスを有効にする (WCF Data Services)」を参照してください。

1 この例では、Address は StreetAddress という名前のプロパティを持つ Customers エンティティの複合型プロパティを表します。 Northwind データ サービスによって使用されるモデルでは、この複合型は明示的に定義されていません。 Entity Framework プロバイダーを使用してデータ モデルを定義している場合、Entity Data Model ツールを使用して、このような複合型を定義できます。 詳細については、「How to: Create and Modify Complex Types (Entity Data Model Tools)」を参照してください。

2 この URI は、バイナリ ラージ オブジェクト (BLOB) を返すプロパティがメディア リンク エントリであるエンティティ (この場合、Customers) に属するメディア リソースとして定義されている場合にサポートされます。 詳細については、「ストリーミング プロバイダー (WCF Data Services)」を参照してください。

バージョン管理の要件

次のデータ サービス構成の動作には、OData プロトコルのバージョン 3 またはそれ以降のバージョンが必要です。

• 応答フィードにリレーションシップ リンク要素を含めるサポート。

• any および all クエリ演算子のサポート。

• サービス アクションおよび機能の定義のサポート。

• 空間データ型のサポート。

• データ モデル注釈の定義によるボキャブラリのサポート。

• $metadata エンドポイント要求に対するデータ モデル検証の無効化のサポート。

次のデータ サービス構成の動作には、OData プロトコルのバージョン 2 またはそれ以降のバージョンが必要です。

• カウント要求とクエリ プロジェクションのサポートには OData プロトコルのバージョン 2.0 およびそれ以降のバージョンが必要です。

• プロジェクションの $select クエリ オプションのサポートには OData プロトコルのバージョン 2.0 およびそれ以降のバージョンが必要です。

詳細については、「データ サービスのバージョン管理 (WCF Data Services)」を参照してください。

関連項目

概念

データ サービスのホスティング (WCF Data Services)

その他の技術情報

データ サービス (WCF Data Services)