SharePoint中的列表(List) 与Content Type 之三

对列表数据使用查询

你可以使用SPQuery对象来获得列表中的具体结果. 当使用SPQuery对象的时候, 你需要创建CAML语句来选择在目标列表中的具体数据. 为了选择已经过期的announcements , 你也许会需要像下面的例子一样使用CAML语句:

SPQuery query = new SPQuery();
query.ViewFields = @"<FieldRef Name='Title'/><FieldRef Name='Expires'/>";
query.Query =
@"<Where>
       <Lt>
         <FieldRef Name='Expires' />
         <Value Type='DateTime'>
         <Today /></Value>
       </Lt>
    </Where>";

SPList list = site.Lists["Litware News"];
SPListItemCollection items = list.GetItems(query);
foreach (SPListItem expiredItem in items)
{
    Console.WriteLine(expiredItem["Title"]);
}

你必须指明你想要在query中返回的fields, 方法是使用ViewFields 属性. 还要注意, 你必须使用field name来指定field, 而不是DisplayName. 如果你试图访问fields而不在ViewFields中指定, 你会遇到类型的ArgumentException的异常.

 

基本的query的语法是:

“<Where><operator><operand /><operand /></operator> </Where>”

 

下表列出了你会在query中使用的基本的CAML, 更完整的列表, 你需要查看SDK.

Element	Description
And	聚合多个条件
BeginsWith	在文本域中从头搜索字符串
Contains	在文本域中搜索字符串
Eq	相等
FieldRef	引用一个field(对GroupBy元素很有用)
Geq	大于等于
GroupBy	通过这些field来分组
Gt	大于
IsNotNull	非空
IsNull	是空
Leq	小于或等于
Lt	小于 Less Than
Neq	不等于
Now	当前的日期和时间
Or	布尔或操作符
OrderBy	排序query的结果
Today	今天的日期
TodayIso	ISO格式的今天的日期
Where	用来指定查询的Where子句

 

SPQuery是一个从单个列表中拿数据的很棒的方法. 更进一步的是, 当你想要查找符合某种条件的列表项是, 使用SPQuery可以比遍历所有列表项的速度明显地加快. 然而, WSS 3.0引入了一种新的query机制, 引入的方式是通过SPSiteDataQuery 类. 使用SPSiteDataQuery 类执行query能够从整个站点集的多个不同的列表中返回列表项. 基于这个原因, 在跨站点查询一般指的就是使用SPSiteDataQuery 的查询.

 

正如你在最后的例子中见到的, 使用SPQuery对象的查询返回一个SPListItemCollection. 使用SPSiteDataQuery 的查询就不一样了, 因为他们返回的是一个ADO.NET的DataTable对象. 与SPQuery一样, 在DataTable中也可以以field的形式返回columns. 比如说, 假设一个场景, 你运行一个查询, 查询站点集中的每一个基于Announcements 类型的列表, 要求返回所有今天创建的Items. 下面的代码示例会展示如何通过创建一个SPSiteDataQuery 对象, 初始化必要的CAML语句, 然后传递他们给当前SPWeb对象的来GetSiteData 方法, 来满足我们的需求,

//A "Recently Published" Feed
using System;
using System.Web;
using Microsoft.SharePoint;
using System.Data;
using System.Xml;
using Microsoft.SharePoint.Utilities;

namespace Litware.ContentWebParts.Handlers
{
    public class RecentPostsHandler : IHttpHandler
    {

        public bool IsReusable
        {
            get { return true; }
        }

        public void ProcessRequest(HttpContext context)
        {
            SPWeb web = SPContext.Current.Web;
            SPSiteDataQuery query = new SPSiteDataQuery();

            query.ViewFields =
            @"<FieldRef Name=""Title""/><FieldRef Name=""PostCategory""/>
        <FieldRef Name=""PublishedDate""/><FieldRef Name=""Body""/>
        <FieldRef Name=""Author""/><FieldRef Name=""Permalink""/>
        <FieldRef Name=""ContentType""/>";

            string queryText =
            @"<Where>
          <And>
            <Eq>
              <FieldRef Name=""ContentType"" />
              <Value Type=""Text"">Post</Value>
            </Eq>
            <Eq>
              <FieldRef Name=""PublishedDate"" />
              <Value Type=""DateTime""><Today /></Value>
            </Eq>
          </And>
        </Where>";

            query.Query = queryText;
            query.Webs = @"<Webs Scope='Recursive' />";
            DataTable table = web.GetSiteData(query);

            context.Response.ContentType = "text/xml";

            XmlTextWriter xw = new XmlTextWriter(context.Response.Output);
            xw.WriteStartElement("rss");
            xw.WriteAttributeString("version", "2.0");
            xw.WriteStartElement("channel");
            xw.WriteElementString("title", "Recently Published: " + web.Title);
            xw.WriteElementString("description",
              "Recently published posts from " + web.Url);
            xw.WriteElementString("link", web.Url);

            foreach (DataRow row in table.Rows)
            {
                xw.WriteStartElement("item");
                xw.WriteElementString("title", (string)row["Title"]);
                xw.WriteElementString("description", ((string)row["Body"]));
                xw.WriteElementString("pubDate", row["PublishedDate"].ToString("r"));

                string author =
                row["Author"].ToString().Split(new string[] { ";#" },
                                               StringSplitOptions.None)[1];
                xw.WriteElementString("author", author);

                string category =
                row["PostCategory"].ToString().Split(new string[] { ";#" },
                                                     StringSplitOptions.None)[1];
                xw.WriteElementString("category", category);

                string link = string.Format(@"/Lists/Posts/Post.aspx?ID={0}",
                                            row["Permalink"].ToString());
                xw.WriteElementString("link", link);

                xw.WriteEndElement(); //item
            }
            xw.WriteEndElement(); //channel
            xw.WriteEndElement(); //rss
        }
    }
}

摘译自:

Inside WSS 3.0 第六章