修复：将 CategoryConfiguration 类与 Commerce Server 2009 中的 CategoryConfiguration 属性一起使用时，不使用目录缓存

症状

请考虑以下情况：

• 在运行 Microsoft Commerce Server 2009 的网站的 web.config 文件中为目录系统启用缓存。

• 使用CategoryConfiguration类指定类别对象的预加载配置。

• 将LoadChildProducts属性设置为True。

• 在CategoryConfiguration属性中指定筛选子句。

• 使用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，如" AW2% "" 不匹配

  • whereClause = "ProductID，如" AW2% "" 匹配

• 如果存在多个关键字值，则在 "whereClause" 属性值的开头或结尾处不允许有空格。 例如：

  • whereClause = "ProductID，如" AW2% "" 不匹配

  • whereClause = "ProductID，如" AW2% "" 不匹配

• "WhereClause" 属性中的 singled 引用的子值必须完全匹配字符串。 例如，假设搜索查询为 "产品 Id"，如 "AW2%" ";在这种情况下，

  • whereClause = "ProductID like" AW2 "不匹配

  • whereClause = "ProductID 像" AW2% "是匹配项

状态

Microsoft 已确认这是在“适用范围”部分中列出的 Microsoft 产品存在的问题。

更多信息

在卸载修补程序期间和之后，请注意以下两点：

1. 可能会显示一个对话框窗口。 对话框窗口警告你需要关闭某些应用程序，然后才能继续 uninstallion 进程。 在这种情况下，接受默认选择，然后单击"确定"按钮继续。

2. 卸载 Commerce Server 2009 的修复程序后，Commerce Server 2009 和 Commerce Server 2007 都可能会显示在 "开始" 菜单中。 在这种情况下，您可以忽略或删除 Commerce Server 2007 菜单项。

有关详细信息，请访问以下 Microsoft 开发人员网络（MSDN）网站：

目录元素 CategoryConfiguration 类 GetCategory 方法若要下载适用于 SharePoint 2010 的 Commerce Server 2009 模板包，请访问以下 Microsoft 网站：

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