設定資料服務 (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> (用於存取資料模型中的資料集) 的屬性。

資料服務的行為由 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 類別可讓您指定下列資料服務行為：

最少資源存取需求

下表詳述為了執行特定作業所必須授與的最少實體集權限。 路徑範例是根據當您完成快速入門時所建立的 Northwind 資料服務。 因為 EntitySetRights 列舉和 ServiceOperationRights 列舉的定義方式是使用 FlagsAttribute 所定義，所以您可以使用邏輯 OR 運算子為單一實體集或作業指定多個權限。 如需詳細資訊，請參閱 HOW TO：啟用資料服務的存取 (WCF Data Services)。

1 在這個範例中，Address 表示 Customers 實體的複雜類型屬性，該實體具有名為 StreetAddress 的屬性。 Northwind 資料服務所使用的模型不會明確定義這個複雜類型。 當此資料模型是使用 Entity Framework 提供者所定義時，您可以使用 實體資料模型 工具來定義這類複雜類型。 如需詳細資訊，請參閱 How to: Create and Modify Complex Types (Entity Data Model Tools)。

2 當傳回二進位大型物件 (BLOB) 的屬性定義為媒體資源時，便可支援這個 URI (此媒體資源屬於媒體連結項目的實體，在這個案例中為 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)