HOW TO：定義服務作業 (WCF Data Services)

WCF Data Services 會將伺服器上定義的方法公開為服務作業。 服務作業可讓資料服務透過 URI 存取在伺服器上定義的方法。 若要定義服務作業，請將 [WebGet] 或 [WebInvoke] 屬性套用至方法。 若要支援查詢運算子，服務作業必須傳回 IQueryable 執行個體。 服務作業可以透過 DataService 上的 CurrentDataSource 屬性存取基礎資料資源。 如需詳細資訊，請參閱服務作業和攔截器 (ADO.NET 資料服務架構)。

本主題的範例定義名為 GetOrdersByCity 的服務作業，此服務作業會針對 Orders 執行個體傳回篩選過的 IQueryable，以及相關的 Order_Details 物件。 此範例存取的 ObjectContext 執行個體為 Northwind 範例資料服務的資料來源。 此服務會在您完成 WCF Data Services 快速入門時建立。

在 Northwind 資料服務中定義服務作業

1. 在 Northwind 資料服務專案中，開啟 Northwind.svc 檔案。

2. 在 Northwind 類別中，定義名為 GetOrdersByCity 的服務作業方法，如下所示：

   <WebGet()> _
   Public Function GetOrdersByCity(ByVal city As String) As IQueryable(Of Order)
   

   [WebGet]
   public IQueryable<Order> GetOrdersByCity(string city)
   

3. 在 Northwind 類別的InitializeService 方法中加入下列程式碼，以存取服務作業：

   config.SetServiceOperationAccessRule( _
       "GetOrdersByCity", ServiceOperationRights.AllRead)
   

   config.SetServiceOperationAccessRule(
       "GetOrdersByCity", ServiceOperationRights.AllRead);
   

查詢 GetOrdersByCity 服務作業

• 在 Web 瀏覽器中輸入下列其中一個 URI，叫用在下列範例中定義的服務作業：

  • https://localhost:12345/Northwind.svc/GetOrdersByCity?city='London'

  • https://localhost:12345/Northwind.svc/GetOrdersByCity?city='London'&$top=2

  • https://localhost:12345/Northwind.svc/GetOrdersByCity?city='London'&$expand=Order_Details&$orderby=RequiredDate desc

範例

下列範例會在 Northwind 資料服務實作名為 GetOrderByCity 的服務作業。 此作業使用 ADO.NET Entity Framework，根據所提供的城市名稱傳回一組 Orders 和相關的 Order_Details 物件，做為 IQueryable 執行個體。

注意：
此服務作業端點支援查詢運算子，因為方法會傳回 IQueryable 執行個體。

<WebGet()> _
Public Function GetOrdersByCity(ByVal city As String) As IQueryable(Of Order)
    If String.IsNullOrEmpty(city) Then
        Throw New ArgumentNullException("city", _
            "You must provide a value for the parameter'city'.")
    End If

    ' Get the ObjectContext that is the data source for the service.
    Dim context As NorthwindEntities = Me.CurrentDataSource

    Try
        Dim selectedOrders = From order In context.Orders.Include("Order_Details") _
                                 Where order.Customer.City = city _
                                 Select order
        Return selectedOrders
    Catch ex As Exception
        Throw New ApplicationException("An error occurred: {0}", ex)
    End Try
End Function

[WebGet]
public IQueryable<Order> GetOrdersByCity(string city)
{
    if (string.IsNullOrEmpty(city))
    {
        throw new ArgumentNullException("city",                   
            "You must provide a value for the parameter'city'.");
    }

    // Get the ObjectContext that is the data source for the service.
    NorthwindEntities context = this.CurrentDataSource;

    try
    {

        var selectedOrders = from order in context.Orders.Include("Order_Details")
                             where order.Customer.City == city
                             select order;

        return selectedOrders;
    }
    catch (Exception ex)
    {
        throw new ApplicationException("An error occurred: {0}", ex);
    }
}

另請參閱

其他資源

定義 WCF Data Services