將篩選描述元新增至搜尋工具方法
篩選描述元可讓模型的取用者在方法執行之前,將值傳遞至方法。 如需詳細資訊,請參閱設計商務資料連線模型 (部分機器翻譯)。
其中一個常見案例是 SharePoint 中的使用者想要擷取符合某些準則的外部內容類型執行個體。 您可以將篩選描述元新增至 [尋找工具] 方法,以支援此案例。
若要將篩選描述元新增至 [尋找工具] 方法
在 [BDC 方法詳細資料] 視窗中,依序展開 [尋找工具] 方法的節點、[參數] 節點,然後新增輸入參數。 如需詳細資訊,請參閱作法:將參數新增至方法 (部分機器翻譯)。
在 [方法詳細資料] 視窗中,選擇此參數的類型描述元。
在功能表列上選擇 [檢視]>[屬性視窗]。
在 [屬性] 視窗中,將 [類型名稱] 屬性設為適用於篩選的資料類型。
例如,篩選可能會使用訂單日期來限制方法所傳回的銷售訂單數目。 若要支援該篩選,類型描述元的 [類型名稱] 屬性必須設為 System.DateTime。
在 [方法詳細資料] 視窗中,展開 [篩選描述元] 節點。
在 [新增篩選描述元] 清單中,選擇 [建立篩選描述元]。
新的篩選描述元會隨即出現在 [篩選描述元] 節點下方。
在功能表列上選擇 [檢視]>[屬性視窗]。
在 [屬性] 視窗中,選擇 [類型] 屬性。
在為 [類型] 屬性顯示的清單中,選擇您想要的篩選模式。
例如,若要建立使用訂單日期來限制 [尋找工具] 方法中所傳回之銷售訂單數目的篩選,請選擇 [比較]。 [比較] 篩選可確保 [尋找工具] 方法只傳回符合特定條件的執行個體。 如需每個篩選模式的詳細資訊,請參閱 BDC 支援的篩選類型 (英文)。
在 [屬性] 視窗中,選擇 [相關聯類型描述元] 屬性。
在為 [相關聯類型描述元] 屬性顯示的清單中,選擇您稍早在此程序中建立的類型描述元。 這會將篩選與 [尋找工具] 方法的輸入參數建立關聯。
將程式碼新增至會傳回資料的 [尋找工具] 方法。 您可以使用輸入參數作為選取查詢中的條件。
下列範例會傳回具有指定訂單日期的銷售訂單。
注意
使用您的伺服器名稱來取代
ServerName
欄位的值。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; }
相關內容
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應