Query Options的一些用法（1）: 展开用户列信息
每个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>
