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

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

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

数据服务的行为是由 DataServiceConfiguration 类的成员以及 DataServiceBehavior 类的成员定义的，可从 DataServiceConfiguration 类的 DataServiceBehavior 属性访问这些行为。 DataServiceConfiguration 类提供给由数据服务实现的 InitializeService 方法，如完成快速入门后创建的以下 Northwind 服务中所示：

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 类用于指定下列数据服务行为：

最低资源访问要求

下表详细描述了为执行特定操作而必须授予的最低实体集权限。 路径示例基于在您完成快速入门时创建的罗斯文数据服务。 由于 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 协议版本 3 或更高版本：

• 支持在响应源中包括关系链接元素。

• 支持 any 和 all 查询运算符。

• 支持定义服务动作和功能。

• 支持空间数据类型。

• 通过定义数据模型注释来提供词汇表支持。

• 支持禁用 $metadata 终结点请求的数据模型验证。

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

• 计数请求和查询投影支持需要 2.0 版 OData 协议及更高版本。

• 投影 $select 查询选项支持需要 2.0 版 OData 协议及更高版本。

有关更多信息，请参见数据服务版本管理（WCF 数据服务）。

请参阅

概念

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

其他资源

数据服务 (WCF Data Services)