需要将单个文档库上的 SPQuery 转换为站点中所有文档库上的 SPSiteDataQuery

Question

我需要帮助将以下代码片段转换为使用 SPSiteDataQuery 而不是 SPQuery b/c 我需要查询站点中的所有文档库。

这是原始代码：

using (SPWeb oWeb = new SPSite(properties.SiteId).OpenWeb(properties.RelativeWebUrl))
                {
                    SPList oList = oWeb.Lists["Quality Documents"];

                    //create query
                    SPQuery oQuery = new SPQuery();

                    //configure the query  //
                    oQuery.Query = "<Where><Eq><FieldRef Name='Document_x0020_Number' /><Value Type='Text'>" + docNum + "</Value></Eq></Where>";

                    //get the collection of items in the list
                    SPListItemCollection oItems = oList.GetItems(oQuery);

                    if (oItems.Count > 0)
                    {
                        newRnd = 0;
                    }
                    else
                    {
                        newRnd = 1;
                    }
                }

这是我的 SPSiteDataQuery 代码，但我不知道它是否正确和/或如何确保代码与上面的代码执行相同的操作。

SPSiteDataQuery q = new SPSiteDataQuery();
q.Lists = "<Lists BaseType='1'/>";
q.Query = "<Where><Eq><FieldRef Name='Document_x0020_Number' /><Value Type='Text'>" + docNum + "</Value></Eq></Where>";
q.Webs = "<Webs Scope='SiteCollection' />";
q.ViewFields = "<FieldRef Name='Document_x0020_Number' />"';
q.RowLimit = 1;

Answer 1

SPQuery 和 SPSiteDataQuery用于指定要查询的列表。 与 SPQuery 不同，在 SPSiteDataQuery 中，您无法指定列表标题来缩小每个站点中的查询范围，您只有 Lists 元素，灵活性较差。 Vincent Rothwell 描述了所有可能性在这里。

这种不灵活性意味着在列表元素代码中使用 BaseType=1 将返回所有文档库中的文档。 避免这种情况的唯一方法是为质量文档部署一个具有自己的 ID 号的自定义列表模板。 然后，您就可以使用 （其中 XYZ 是 ID 号，用于将结果范围缩小到该类型的列表）。 否则，您将需要过滤返回的结果，以便它们仅包含质量文档库中的条目。

除此之外，您的代码看起来是等效的。 您可能还想查看 CrossListQueryInfo和 CrossListQueryCache（如果您运行的是 MOSS）。 这些允许您缓存 SPSiteDataQuery 样式的查询。 有关详细信息，请参阅 Jeff Dalton 的这篇文章这。

更新有关对象处置的评论：

您的代码将泄漏 SPSite 对象 - 这也需要一个 using 子句。 将当前的 using 行替换为以下行：

using (SPSite oSite = new SPSite(properties.SiteId))
using (SPWeb oWeb = oSite.OpenWeb(properties.RelativeWebUrl))
{
    // Your code
}

此外，使用 SPDisposeCheck 也很容易。 要与 Visual Studio 集成，请将以下行添加到项目的构建后事件中：

“%ProgramFiles%\Microsoft\SharePoint
处置检查\SPDisposeCheck.exe”
$(目标路径)

如果存在内存泄漏，构建现在将失败。 检查“输出”窗口以获取有关它们所在位置的详细信息。 请注意，SPDisposeCheck 有时会报告误报，并且可以忽略这些（阅读文档以了解如何操作）。