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;#用户显示名,#域账号,#邮箱,#leiq@hp.com,#用户显示名(?)"

 

<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,#leiq@hp.com,#leiq@hp.com,#Qin,, Lei (Lambert,, ES-Apps-GD-China-SH)" ows_Editor="1;#Qin,, Lei (Lambert,, ES-Apps-GD-China-SH),#ASIAPACIFIC\qinle,#leiq@hp.com,#leiq@hp.com,#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>