將篩選描述元新增至搜尋工具方法

篩選描述元可讓模型的取用者在方法執行之前，將值傳遞至方法。 如需詳細資訊，請參閱設計商務資料連線模型 (部分機器翻譯)。

其中一個常見案例是 SharePoint 中的使用者想要擷取符合某些準則的外部內容類型執行個體。 您可以將篩選描述元新增至 [尋找工具] 方法，以支援此案例。

若要將篩選描述元新增至 [尋找工具] 方法

1. 在 [BDC 方法詳細資料] 視窗中，依序展開 [尋找工具] 方法的節點、[參數] 節點，然後新增輸入參數。 如需詳細資訊，請參閱作法：將參數新增至方法 (部分機器翻譯)。

2. 在 [方法詳細資料] 視窗中，選擇此參數的類型描述元。

3. 在功能表列上選擇 [檢視]>[屬性視窗]。

4. 在 [屬性] 視窗中，將 [類型名稱] 屬性設為適用於篩選的資料類型。

   例如，篩選可能會使用訂單日期來限制方法所傳回的銷售訂單數目。 若要支援該篩選，類型描述元的 [類型名稱] 屬性必須設為 System.DateTime。

5. 在 [方法詳細資料] 視窗中，展開 [篩選描述元] 節點。

6. 在 [新增篩選描述元] 清單中，選擇 [建立篩選描述元]。

   新的篩選描述元會隨即出現在 [篩選描述元] 節點下方。

7. 在功能表列上選擇 [檢視]>[屬性視窗]。

8. 在 [屬性] 視窗中，選擇 [類型] 屬性。

9. 在為 [類型] 屬性顯示的清單中，選擇您想要的篩選模式。

   例如，若要建立使用訂單日期來限制 [尋找工具] 方法中所傳回之銷售訂單數目的篩選，請選擇 [比較]。 [比較] 篩選可確保 [尋找工具] 方法只傳回符合特定條件的執行個體。 如需每個篩選模式的詳細資訊，請參閱 BDC 支援的篩選類型 (英文)。

10. 在 [屬性] 視窗中，選擇 [相關聯類型描述元] 屬性。

11. 在為 [相關聯類型描述元] 屬性顯示的清單中，選擇您稍早在此程序中建立的類型描述元。 這會將篩選與 [尋找工具] 方法的輸入參數建立關聯。

12. 將程式碼新增至會傳回資料的 [尋找工具] 方法。 您可以使用輸入參數作為選取查詢中的條件。

    下列範例會傳回具有指定訂單日期的銷售訂單。

    注意

    使用您的伺服器名稱來取代 ServerName 欄位的值。

    C#

    public static IEnumerable<SalesOrderHeader> ReadList(DateTime OrderDateParam)
    {
        const string ServerName = "MySQLServerName";
        AdventureWorksDataContext dataContext = new AdventureWorksDataContext
              ("Data Source=" + ServerName + ";" +
               "Initial Catalog=AdventureWorks;Integrated Security=True");
    
        DateTime NoValuePassedIn = Convert.ToDateTime("1/1/1900 12:00:00 AM");
        DateTime DefaultDateTime = Convert.ToDateTime("2001-09-01 00:00:00.000");
    
        // If the user does not provide a value for the filter.
        if (OrderDateParam == NoValuePassedIn)
        {
            // Use a default date time value.
            OrderDateParam = DefaultDateTime;
        }
    
        IEnumerable<SalesOrderHeader> SalesOrderHeader =
            from salesOrderHeaders in dataContext.SalesOrderHeaders
            where salesOrderHeaders.OrderDate == OrderDateParam
            select salesOrderHeaders;
        return SalesOrderHeader;
    }
    

    VB

    Public Shared Function ReadList(ByVal OrderDateParam As DateTime) As IEnumerable(Of SalesOrderHeader)
        Const ServerName As String = "MySQLServerName"
        Dim dataContext As AdventureWorksDataContext = _
            New AdventureWorksDataContext("Data Source=" & ServerName & _
                ";Initial Catalog=AdventureWorks;Integrated Security=True")
    
        Dim NoValuePassedIn As DateTime = Convert.ToDateTime("1/1/1900 12:00:00 AM")
        Dim DefaultDateTime As DateTime = Convert.ToDateTime("2001-09-01 00:00:00.000")
    
        ' If the user does not provide a value for the filter.
        If OrderDateParam = NoValuePassedIn Then
            ' Use a default date time value.
            OrderDateParam = DefaultDateTime
        End If
    
        Dim SalesOrderHeader As IEnumerable(Of SalesOrderHeader) = _
            From SalesOrderHeaders In dataContext.SalesOrderHeaders _
            Where SalesOrderHeaders.OrderDate = OrderDateParam _
            Select SalesOrderHeaders
        Return SalesOrderHeader
    End Function
    

相關內容

• 如何：新增 Finder 方法
• 作法：新增特定 [尋找工具] 方法
• 作法：將參數新增至方法
• 作法：定義參數的類型描述元
• 設計商務資料連線模型
• 將商業資料整合至 SharePoint