修正：當您將 CategoryConfiguration 類別與 Commerce Server 2009 中的 CategoryConfiguration 屬性搭配使用時，不會使用目錄緩存。

徵狀

請試想下列案例：

• 您可以在執行 Microsoft Commerce Server 2009 之網站的 web.config 檔案中，為目錄系統啟用快取。

• 您可以使用CategoryConfiguration類別來指定類別物件的預先載入的配置。

• 您將LoadChildProducts屬性設為True。

• 您可以在CategoryConfiguration ChildProducts屬性中指定篩選子句。

• 您可以使用GetCategory方法或GetProduct方法來檢索CategoryConfiguration物件的子類別或子產品。

在這種情況下，可能無法使用目錄緩衝來檢索子類別和子產品。 因此，當負載較高時，網站可能會遇到效能降低的效能。例如，您有一個使用 AdventureWorks 範例目錄的網站。 您執行下列程式碼範例，以取得類別物件的顯示名稱。 在這個範例中，程式碼會在每次都從目錄資料庫查詢資料，不過已啟用目錄緩存。

CategoryConfiguration categoryConfiguration = new CategoryConfiguration();  categoryConfiguration.LoadChildProducts = true;  categoryConfiguration.ChildProducts.SqlWhereClause = "[IsVisible] = 1";  var catalogContext = CommerceContext.Current.CatalogSystem.CatalogContext;  Category category = catalogContext.GetCategory("AdventureWorks Catalog", "SleepingBags");  Response.Write(category.DisplayName);

注意： 當您在程式碼範例中使用GetProduct方法時，就會發生這個問題。Microsoft 只提供圖例的程式設計範例，不含任何明示或默示的保證。 這包括但不限於針對特定用途的適售性或適用性的默示擔保。 本文假設您熟悉所示範的程式設計語言，以及用來建立及偵錯工具的工具。 Microsoft 支援工程師可以協助說明特定程式的功能。 不過，它們不會修改這些範例來提供額外的功能或構造程式，以符合您的特定需求。

解決方案

若要解決此問題，請將此熱修復程式套用到執行 Commerce Server 2009 的伺服器。套用此熱修復程式後，當您使用「whereClause」篩選時，就可以在目錄快取中緩存子產品和子類別。 根據預設，包含 where 子句的任何查詢都會略過目錄快取。 若要啟用快取，您必須新增「cacheFilter」區段，並在 Commerce Server 網站的 web.config 檔案中正確設定。"CacheFilter" 區段提供下列屬性：

• "WhereClause" 屬性。

• "ExactMatch" 屬性。

您可以使用下列其中一個選項來管理要快取的 where 子句：

• 在 "whereClause" 屬性中指定整個 where 子句，然後將 "exactMatch" 屬性設定為True。

• 在 "whereClause" 屬性中指定 where 子句，然後將 "exactMatch" 屬性設定為False。 這可讓 Commerce Server 將與部分相符的任何 where 子句快取到在設定檔中指定的內容。

注意： "ExactMatch" 屬性是選擇性的。 根據預設，如果您省略 "exactMatch" 屬性，則會將它設定為True。下列範例顯示如何修改配置節。 這個範例也會顯示「exactMatch」屬性的用法。

<catalog><catalogSets .../>      <cache enable="true">        <cacheFilter>          <add whereClause="WHERE [ListPrice] between 0 AND 1000'" />          <add whereClause="isActive" exactMatch="False" />          ...         </cacheFilter>       </cache> </catalog>

在 cacheFilter 區段中定義「whereClause」屬性值的規則請注意，"cacheFilter" 區段中 "whereClause" 屬性的值是符合字串的。 例如，必須遵循下列規則：

• 在 "whereClause" 屬性值關鍵字中只允許一個空格。 例如：

  • whereClause = "ProductID like" AW2% "" 不符合

  • whereClause = "ProductID like" AW2% "" 與您相符

• 如果有多個關鍵字值，則「whereClause」屬性值的開頭或結尾不允許有任何空格。 例如：

  • whereClause = "ProductID like" AW2% "" 不符合

  • whereClause = "ProductID like" AW2% "" 不符合

• 在「whereClause」屬性內，單一加上引號的子值必須完全符合字串。 例如，假設搜尋查詢是 "ProductID 為" AW2% ""，在此情況下，

  • whereClause = "ProductID like" AW2 "不符合

  • whereClause = "ProductID like" AW2% "是一個相符專案

狀態

Microsoft 已確認＜適用於＞一節中所列的 Microsoft 產品確實有上述問題。

其他相關資訊

在卸載此熱修復程式期間和之後，請注意下列兩個點：

1. 對話方塊視窗可能會顯示。 對話方塊視窗會警告您必須關閉某些應用程式，才能繼續進行 uninstallion 處理常式。 在這種情況下，接受預設的選取範圍，然後按一下[確定]按鈕繼續。

2. 在您卸載 Commerce Server 2009 的修復程式後，Commerce Server 2009 和 Commerce Server 2007 可能會出現在 [開始] 功能表中。 在這種情況下，您可以忽略或刪除 Commerce Server 2007 功能表項目。

如需詳細資訊，請造訪下列 Microsoft 開發人員網路（MSDN）網站：

Catalog 元素 CategoryConfiguration Class GetCategory 方法若要下載適用于 SharePoint 2010 的 Commerce Server 2009 範本套件，請造訪下列 Microsoft 網站：

http://www.microsoft.com/download/en/details.aspx?FamilyID=CFD0C459-5A11-4DE6-9085-52D59E8D38E6&displaylang=en