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>

staticXmlNode 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;

}

}

  

staticvoid Main(string[] args)

{

  

Lists client = newLists();

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的类型。

staticXmlNode 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;

}

}

staticvoid Main(string[] args)

{

  

Lists client = newLists();

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。

staticXmlNode QueryOptions

{

get

{

  

XmlElement queryOptions = _camlDoc.CreateElement(“QueryOptions”);

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

return queryOptions;

}

}

staticvoid Main(string[] args)

{

  

Lists client = newLists();

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),#ASIAPACIFICqinle,#[email protected],#[email protected],#Qin,, Lei (Lambert,, ES-Apps-GD-China-SH)” ows_Editor=”1;#Qin,, Lei (Lambert,, ES-Apps-GD-China-SH),#ASIAPACIFICqinle,#[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>

  

本文链接



You must enable javascript to see captcha here!

Copyright © All Rights Reserved · Green Hope Theme by Sivan & schiy · Proudly powered by WordPress

无觅相关文章插件,快速提升流量