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

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

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

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

' This method is called only once to initialize service-wide policies.
Public Shared Sub InitializeService(ByVal config As DataServiceConfiguration)
    ' Set the access rules of feeds exposed by the data service, which is
    ' based on the requirements of client applications.
    config.SetEntitySetAccessRule("Customers", EntitySetRights.ReadSingle)
    config.SetEntitySetAccessRule("Employees", EntitySetRights.ReadSingle)
    config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead _
        And EntitySetRights.WriteAppend _
        And EntitySetRights.WriteMerge)
    config.SetEntitySetAccessRule("Order_Details", EntitySetRights.All)
    config.SetEntitySetAccessRule("Products", EntitySetRights.ReadMultiple)

    ' Set page size defaults for the data service.
    config.SetEntitySetPageSize("Orders", 20)
    config.SetEntitySetPageSize("Order_Details", 50)
    config.SetEntitySetPageSize("Products", 50)

    ' Paging requires v2 of the OData protocol.
    config.DataServiceBehavior.MaxProtocolVersion = _
        System.Data.Services.Common.DataServiceProtocolVersion.V2
End Sub

// This method is called only once to initialize service-wide policies.
public static void InitializeService(DataServiceConfiguration config)
{
    // Set the access rules of feeds exposed by the data service, which is
    // based on the requirements of client applications.
    config.SetEntitySetAccessRule("Customers", EntitySetRights.ReadSingle);
    config.SetEntitySetAccessRule("Employees", EntitySetRights.ReadSingle);
    config.SetEntitySetAccessRule("Orders", EntitySetRights.AllRead 
        & EntitySetRights.WriteAppend
        & EntitySetRights.WriteMerge);
    config.SetEntitySetAccessRule("Order_Details", EntitySetRights.All);
    config.SetEntitySetAccessRule("Products", EntitySetRights.ReadMultiple);

    // Set page size defaults for the data service.
    config.SetEntitySetPageSize("Orders", 20);
    config.SetEntitySetPageSize("Order_Details", 50);
    config.SetEntitySetPageSize("Products", 50);

    // Paging requires v2 of the OData protocol.
    config.DataServiceBehavior.MaxProtocolVersion =
        System.Data.Services.Common.DataServiceProtocolVersion.V2;
}

データ サービス構成設定

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 プロトコルのバージョン 2 またはそれ以降のバージョンが必要です。

• カウント要求のサポート。

• 射影の $select クエリ オプションのサポート。

詳細については、「WCF Data Services の複数のバージョンの使用」を参照してください。

参照

概念

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

その他のリソース

WCF Data Services の定義