SharePoint【Query Options系列】-- Query Options的一些用法 01. 展开用户列信息

每个SharePoint开发者打交道很多的一个肯定是使用CAML查询。针对一个非服务端开发，为了查询到想要的数据，不得不依赖CAML。

只要使用CAML查询，没有没有用过下面的方法的。从官方文档看，一个典型的查询包含了如下的参数。

public XmlNode GetListItems ( 

    string listName, 

    string viewName, 

    XmlNode query, 

    XmlNode viewFields, 

    string rowLimit, 

    XmlNode queryOptions, 

    string webID 

) 

列表名，视图名，CAML查询，ViewFields(汗，不会翻译…), 限制返回记录数，查询选项，对应站点ID。

 

其中有点意思的是Query Options（查询选项）。官方文档给出了几个常用的用法。问题是，这些就是全部吗？有没有别的有意思的可以挖掘呢？

 

一起看看吧。

 

首先建立一个最简单的列表，添加一条数据。

 

 

写一个很简单的Console

/// <summary> 

/// 查询所有的数据 

/// </summary> 

static XmlNode QueryAll 

{ 

　　get { 

　　　　XmlElement query = _camlDoc.CreateElement("Query"); 

　　　　System.Text.StringBuilder querySB = new System.Text.StringBuilder(); 

　　　　querySB.Append(" <Where>"); 

　　　　querySB.Append(" <Neq>"); 

　　　　querySB.Append(" <FieldRef Name=\"ID\" />"); 

　　　　querySB.Append(" <Value Type=\"Counter\">0</Value>"); 

　　　　querySB.Append(" </Neq>"); 

　　　　querySB.Append(" </Where>"); 

　　　　query.InnerXml = querySB.ToString(); 

　　　　return query; 

　　} 

} 

   

static void Main(string[] args) 

{ 

　　Lists client = new Lists(); 

　　client.Url = webUrl + "/_vti_bin/lists.asmx"; 

　　client.Credentials = System.Net.CredentialCache.DefaultCredentials; 

　　XmlNode resultNode = client.GetListItems(listName, String.Empty, QueryAll, null, "0", null, String.Empty); 

　　Console.ReadLine(); 

} 

 

 

运行，得到如下结果，包含的列表的一条数据。

 

<rs:data ItemCount="1" xmlns:rs="urn:schemas-microsoft-com:rowset"> 



<z:row ows_Title="Test01" ows_MetaInfo="1;#" ows__ModerationStatus="0" ows__Level="1" ows_ID="1" ows_UniqueId="1;#{E1F2046C-16AC-4650-8EE3-73E12ED5E833}" ows_owshiddenversion="1" ows_FSObjType="1;#0" ows_Created="2012-11-30 01:37:17" ows_PermMask="0x7fffffffffffffff" ows_Modified="2012-11-30 01:37:17" ows_FileRef="1;#teams/smetechcom/Lists/QueryOptionsDemo/1_.000" xmlns:z="#RowsetSchema" /> 



</rs:data>

 

 

现在，增加View Fields，引入Author和Editor。这两个是UserField的类型。

 

static XmlNode ViewFields 

{ 

        get 

        { 

                XmlElement viewFields = _camlDoc.CreateElement("ViewFields"); 

                System.Text.StringBuilder viewFieldsSB = new         System.Text.StringBuilder(); 

                #region View Fields 

                viewFieldsSB.Append(" <FieldRef Name=\"Title\" />"); 

                viewFieldsSB.Append(" <FieldRef Name=\"Author\" />"); 

                viewFieldsSB.Append(" <FieldRef Name=\"Editor\" />"); 

                #endregion 

                string sResult = viewFieldsSB.ToString(); 

                viewFields.InnerXml = viewFieldsSB.ToString(); 

                return viewFields; 

        } 

} 

static void Main(string[] args) 

{ 

        Lists client = new Lists(); 

        client.Url = webUrl + "/_vti_bin/lists.asmx"; 

        client.Credentials = System.Net.CredentialCache.DefaultCredentials; 

        XmlNode resultNode = client.GetListItems(listName,         String.Empty, QueryAll, ViewFields, "0", null, String.Empty); 

        Console.ReadLine(); 

} 

 

 

运行，得到下面结果。

 

<rs:data ItemCount="1" xmlns:rs="urn:schemas-microsoft-com:rowset"> 



<z:row ows_Title="Test01" ows_Author="1;#Qin, Lei (Lambert, ES-Apps-GD-China-SH)" ows_Editor="1;#Qin, Lei (Lambert, ES-Apps-GD-China-SH)" ows_MetaInfo="1;#" ows__ModerationStatus="0" ows__Level="1" ows_ID="1" ows_UniqueId="1;#{E1F2046C-16AC-4650-8EE3-73E12ED5E833}" ows_owshiddenversion="1" ows_FSObjType="1;#0" ows_Created="2012-11-30 01:37:17" ows_PermMask="0x7fffffffffffffff" ows_Modified="2012-11-30 01:37:17" ows_FileRef="1;#teams/smetechcom/Lists/QueryOptionsDemo/1_.000" xmlns:z="#RowsetSchema" /> 



</rs:data>

 

 

这个时候，这条数据中创建者和修改者得信息就出来了。格式为"User Information List中的Id;#用户的显示名"。

 

问题来了，如果我们需要知道这个人对应的邮件或者域账号呢？很多时候，我们的方案都是要根据人去查找权限，查找邮箱。显然这么基本的信息是不够的。

 

一个解决方案是根据这个ID去查询User Information List，来得到用户的其他信息。

 

另外一个解决方案就是增加一个Query Options。

 

static XmlNode QueryOptions 

{ 

    get { 

        XmlElement queryOptions = _camlDoc.CreateElement("QueryOptions"); 

        queryOptions.InnerXml = "<ExpandUserField>True</ExpandUserField>"; 

        return queryOptions; 

    } 

}

 

static void Main(string[] args) 

{ 

    Lists client = new Lists(); 

    client.Url = webUrl + "/_vti_bin/lists.asmx"; 

    client.Credentials = System.Net.CredentialCache.DefaultCredentials; 

    XmlNode resultNode = client.GetListItems(listName, String.Empty, QueryAll, ViewFields, "0", QueryOptions, String.Empty); 

    Console.ReadLine(); 

} 

 

 

再次运行看看，你会发现更加详细的信息直接通过web service返回了。返回的格式为："User Information List中的Id;#用户显示名,#域账号,#邮箱,#[email protected],#用户显示名(?)"

 

<rs:data ItemCount="1" xmlns:rs="urn:schemas-microsoft-com:rowset"> 



<z:row ows_Title="Test01" ows_Author="1;#Qin,, Lei (Lambert,, ES-Apps-GD-China-SH),#ASIAPACIFIC\qinle,#[email protected],#[email protected],#Qin,, Lei (Lambert,, ES-Apps-GD-China-SH)" ows_Editor="1;#Qin,, Lei (Lambert,, ES-Apps-GD-China-SH),#ASIAPACIFIC\qinle,#[email protected],#[email protected],#Qin,, Lei (Lambert,, ES-Apps-GD-China-SH)" ows_MetaInfo="1;#" ows__ModerationStatus="0" ows__Level="1" ows_ID="1" ows_UniqueId="1;#{E1F2046C-16AC-4650-8EE3-73E12ED5E833}" ows_owshiddenversion="1" ows_FSObjType="1;#0" ows_Created="2012-11-30 01:37:17" ows_PermMask="0x7fffffffffffffff" ows_Modified="2012-11-30 01:37:17" ows_FileRef="1;#teams/smetechcom/Lists/QueryOptionsDemo/1_.000" xmlns:z="#RowsetSchema" /> 



</rs:data>