配置数据服务（WCF 数据服务）

通过使用 WCF 数据服务 ，可以创建用于公开 开放式数据协议 (OData) 源的数据服务。这些源中的数据可来自各种数据源。WCF 数据服务 使用数据提供程序将此数据公开为 OData 源。这些提供程序包括一个实体框架 提供程序、一个反射提供程序和一组自定义数据服务提供程序接口。提供程序实现为服务定义数据模型。有关更多信息，请参见数据服务提供程序（WCF 数据服务）。

在 WCF 数据服务 中，数据服务是一个从 DataService 类继承的类，而数据服务的类型是数据模型的实体容器。此实体容器具有一个或多个属性，这些属性返回用于访问数据模型中的实体集的 IQueryable。

数据服务的行为是由 DataServiceConfiguration 类的成员以及 DataServiceBehavior 类的成员定义的，可从 DataServiceConfiguration 类的 DataServiceBehavior 属性访问这些行为。DataServiceConfiguration 类提供给由数据服务实现的 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 类用于指定下列数据服务行为：

最低资源访问要求

下表详细描述了为执行特定操作而必须授予的最低实体集权限。路径示例基于在您完成快速入门时创建的罗斯文数据服务。由于 EntitySetRights 枚举和 ServiceOperationRights 枚举都是通过使用 FlagsAttribute 定义的，因此您可以使用逻辑 OR 运算符来针对单个实体集或操作指定多个权限。有关更多信息，请参见如何：启用对数据服务的访问（WCF 数据服务）。

1 在此示例中，Address 表示有一个名为 StreetAddress 的属性的 Customers 实体的复杂类型属性。罗斯文数据服务所使用的模型不会显式定义此复杂类型。如果数据模型是使用实体框架 提供程序定义的，则可以使用实体数据模型 工具来定义这样的复杂类型。有关更多信息，请参见How to: Create and Modify Complex Types (Entity Data Model Tools)。

2 如果将返回二进制大型对象 (BLOB) 的属性定义为一个媒体资源，而此媒体资源属于一个作为媒体链接入口的实体（在此例中为 Customers），则支持此 URI。有关更多信息，请参见流提供程序（WCF 数据服务）。

版本控制要求

下面的数据服务配置行为要求使用 OData 协议版本 2 或更高版本：

• 计数请求支持。

• 投影的 $select 查询选项支持。

有关更多信息，请参见使用 WCF 数据服务的多个版本。

另请参见

概念

承载数据服务（WCF 数据服务）

其他资源

定义 WCF 数据服务