共用方式為

新增特定搜尋工具方法

  • 發行項

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

建立特定 Finder 方法

  1. 在 [BDC 設計工具] 上，選擇實體。

    如需如何在 Visual Studio 中將實體新增至 [BDC 設計工具] 的詳細資訊，請參閱如何：將實體新增至模型。

  2. 在功能表列上，選擇 [檢視]>[其他視窗] 、[BDC 方法詳細資料]。

    [BDC 方法詳細資料] 視窗隨即開啟。 如需該視窗的詳細資訊，請參閱 BDC 模型設計工具概觀。

  3. 在 [新增方法] 清單中，選擇 [建立特定搜尋工具方法]。

    Visual Studio 會將下列元素新增至模型。 這些元素會出現在 [BDC 方法詳細資料] 視窗中。

    • 方法。

    • 方法的輸入參數。

    • 方法的傳回參數。

    • 每個參數的類型描述元。

    • 方法的方法執行個體。

      如需詳細資訊，請參閱設計商務資料連線模型。

  4. 開啟 Visual Studio 的 [屬性] 視窗。

  5. 將傳回參數的類型描述元設定為實體類型描述元。 如需如何建立實體類型描述元的相關資訊，請參閱如何：定義參數的類型描述元。

    注意

    如果您已將 Finder 方法新增至實體，則不需要執行此步驟。 Visual Studio 會使用您在 Finder 方法中定義的類型描述元。

    注意

    如果實體類型的識別碼欄位代表資料庫資料表中未自動產生的欄位，請將 [唯讀] 屬性設定為 True。

  6. 在 [方法詳細資料] 視窗中，選擇方法的方法執行個體。

  7. 在 [屬性視窗] 中，將 [傳回參數名稱] 屬性設定為方法的傳回參數名稱。 如需方法執行個體屬性的詳細資訊，請參閱 MethodInstance。

  8. 在 [方案總管] 中，開啟為實體產生的服務程式碼檔案的捷徑功能表，然後選擇 [檢視程式碼]。

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

  9. 將程式碼新增至特定 Finder 方法。 這個程式碼會執行下列工作：

    • 從資料來源擷取記錄。

    • 將實體傳回 BDC 服務。

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

      注意

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

      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;
}

相關內容