WCF Data Service 實戰總結 (二)：建立 OData 服務完整流程

前置條件

WCF Data Service 需要 ORM 支援，主流皆相容：Entity Framework、LINQ to SQL、ALinq 等。

步驟 1：建立 Model（略）

依選用 ORM 建立實體類別與資料庫對應，此處假設已有 NorthwindEntities Context。

步驟 2：新增 WCF Data Service

右鍵專案 > Add > New Item > WCF Data Service（若無此範本請安裝 WCF Data Service Tools）。

步驟 3：設定資料來源與存取規則

public class NorthwindDataService : DataService<NorthwindEntities>
{
    public static void InitializeService(IDataServiceConfiguration config)
    {
        // 範例：開放 Products、Categories 讀取權限
        config.SetEntitySetAccessRule("Products", EntitySetRights.AllRead);
        config.SetEntitySetAccessRule("Categories", EntitySetRights.AllRead);
        
        // 開放 Service Operation
        // config.SetServiceOperationAccessRule("MyOperation", ServiceOperationRights.All);
        
        // 設定分頁大小
        config.SetEntitySetPageSize("Products", 20);
        
        // 允許詳細錯誤資訊（開發階段）
        config.UseVerboseErrors = true;
    }
}

關鍵設定說明

驗證服務

• 瀏覽 .svc 根網址：顯示服務文件與實體集連結。
• 查詢 /Products?$format=json&$top=5 驗證 JSON 輸出與分頁。
• 嘗試 POST/PUT/DELETE 驗證寫入權限（需正確設定 AccessRule）。

常見問題

1. 找不到 WCF Data Service 範本：Visual Studio Installer > Individual components > WCF Data Services 5.6.4 Tools。
2. 循環參考導致序列化失敗：實體類別加上 [IgnoreDataMember] 或設定 config.DataServiceBehavior.MaxProtocolVersion = V3 並使用 PreserveReferencesHandling。
3. 大量資料效能：啟用伺服器分頁、投影（$select）、索引優化。