HOW TO：加入搜尋方法

發行項
08/12/2011

若要啟用商務資料連接服務，以便在 Web 組件或清單中顯示實體清單，您必須建立「搜尋」(Finder) 方法。搜尋方法是一種特殊方法，可傳回實體執行個體的集合。如需詳細資訊，請參閱設計商務資料連接模型。

若要建立搜尋方法

在 BDC 設計工具上，選取實體。如需如何將實體加入至 Visual Studio BDC 設計工具的詳細資訊。如需詳細資訊，請參閱 HOW TO：將實體加入至模型。
按一下 [檢視] 功能表上的 [其他視窗]，然後按一下 [BDC 方法詳細資料]。

[BDC 方法詳細資料] 視窗隨即開啟。如需 [BDC 方法詳細資料] 視窗的詳細資訊，請參閱 BDC 模型設計工具概觀。
在 [BDC 方法詳細資料] 視窗的 [新增方法] 下拉式清單中，選取 [建立搜尋方法]。

Visual Studio 會加入方法、傳回參數以及型別描述元。
將型別描述元設定為實體集合型別描述元。如需如何建立實體集合型別描述元的詳細資訊，請參閱 HOW TO：定義參數的型別描述元。

注意事項

如果您已經在實體中加入了特定搜尋方法，就不需執行此步驟。 Visual Studio 會使用您在特定搜尋方法中定義的型別描述元。
在 [方案總管] 中，以滑鼠右鍵按一下針對實體所產生的服務程式碼檔案，然後按一下 [檢視程式碼]。如需服務程式碼檔案的詳細資訊，請參閱建立商務資料連接模型。

注意事項
如果您已經在實體中加入了特定搜尋方法，就不需執行此步驟。 Visual Studio 會使用您在特定搜尋方法中定義的型別描述元。

將程式碼加入至搜尋方法。這個程式碼將執行下列工作：

擷取資料來源中的資料。
將實體清單傳回至 BDC 服務。

下列範例會使用 SQL Server 之 AdventureWorks 範例資料庫中的資料，傳回 Contact 實體的集合。

注意事項
將 ServerName 欄位的值替換成您的伺服器名稱。

Public Shared Function ReadList() As IEnumerable(Of Contact)
    Const ServerName As String = "MySQLServerName"
    Dim dataContext As AdventureWorksDataContext = _
        New AdventureWorksDataContext("Data Source=" & ServerName & _
            ";Initial Catalog=AdventureWorks;Integrated Security=True")

    Dim Contacts As IEnumerable(Of Contact) = _
        From TempContacts In dataContext.Contacts.Take(20) _
              Select TempContacts
    Return Contacts
End Function

public static IEnumerable<Contact> ReadList()
{
    const string ServerName = "MySQLServerName";
    AdventureWorksDataContext dataContext = new AdventureWorksDataContext
          ("Data Source=" + ServerName + ";" +
           "Initial Catalog=AdventureWorks;Integrated Security=True");

    IEnumerable<Contact> Contacts =
        from contacts in dataContext.Contacts.Take(20)
        select contacts;
    return Contacts;

}

請參閱

HOW TO：加入搜尋方法

若要建立搜尋方法

請參閱

工作

概念

其他資源

其他資源