HOW TO：加入特定搜尋方法

發行項
02/28/2013

您可以建立「特定搜尋」(Specific Finder) 方法，傳回單一實體執行個體。，會在使用者選取商務資料 Web 組件或外部清單中實體時，商務資料連接 (BDC) (BDC) 服務執行特定搜尋方法。如需詳細資訊，請參閱設計商務資料連接模型。

若要建立特定搜尋方法

在 [BDC 設計工具]，請選取實體。

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

[BDC 方法詳細資料] 視窗隨即開啟。如需這個視窗的詳細資訊，請參閱 BDC 模型設計工具概觀。
在 [加入方法] 清單中，選取 [建立特定搜尋方法]。

Visual Studio 會將下列項目加入至模型。這些項目會顯示在 [BDC 方法詳細資料] 視窗中。
- 方法。
- 此方法的輸入參數。
- 方法的傳回參數。
- 各個參數的型別描述元。
- 此方法的方法執行個體。
如需詳細資訊，請參閱設計商務資料連接模型。
開啟 Visual Studio 的 [屬性視窗]。
將傳回參數的型別描述元設定為實體型別描述元。如需如何建立實體型別描述元的詳細資訊，請參閱 HOW TO：定義參數的型別描述元。

注意事項

如果您加入了搜尋方法，就不需執行此步驟。Visual Studio 會使用您在搜尋方法中定義的型別描述元。

注意事項

如果實體型別的識別項欄位在自動產生的代表資料庫資料表中的資料行，請將識別項欄位的 [唯讀] 屬性設定為 [如此。]。
在 [方法詳細資料] 視窗中，選取方法的方法執行個體。
在 [屬性視窗] 中，將 [傳回參數名稱] 屬性設為方法之傳回參數的名稱。如需方法執行個體屬性的詳細資訊，請參閱 MethodInstance (英文)。
在 [方案總管]，開啟針對實體所產生服務程式碼檔案的捷徑功能表，然後選取 [檢視程式碼]。

實體服務程式碼檔案會在程式碼編輯器中開啟。如需實體服務程式碼檔案的詳細資訊，請參閱建立商務資料連接模型。

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

注意事項
如果實體型別的識別項欄位在自動產生的代表資料庫資料表中的資料行，請將識別項欄位的 [唯讀] 屬性設定為 [如此。]。

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

從資料來源擷取資料錄。
將實體傳回至 BDC 服務。

下列範例會從 SQL Server 的 AdventureWorks 範例資料庫傳回連絡人。

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

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

    Dim Contact As Contact = _
        (From TempContacts In dataContext.Contacts.AsEnumerable().Take(20) _
        Where TempContacts.ContactID = contactID _
        Select TempContacts).[Single]()
    Return Contact
End Function

public static Contact ReadItem(int contactID)
{
    const string ServerName = "MySQLServerName";
    AdventureWorksDataContext dataContext = new AdventureWorksDataContext
          ("Data Source=" + ServerName + ";" +
           "Initial Catalog=AdventureWorks;Integrated Security=True");

    Contact Contact =
        (from contacts in dataContext.Contacts.AsEnumerable().Take(20)
         where contacts.ContactID == contactID
         select contacts).Single();
    return Contact;
}

請參閱

共用方式為

HOW TO：加入特定搜尋方法

若要建立特定搜尋方法

請參閱

工作

概念

其他資源

其他資源