SharePoint中CAML使用的一些总结

协作应用程序标记语言 (CAML) 是一种基于 XML 的语言，用于在 Windows SharePoint Services 中定义在网站和列表中使用的字段和视图。CAML 还用于在网站设置过程中定义 Windows SharePoint Services 数据库中的表。也可以对列表进行更新，在使用SharePoint Web Service的时候十分重要。详细的规范请参考http://msdn.microsoft.com/zh-cn/library/ms462365.aspx，本文列出一些常用的和重要的信息。

1. 一些属性 

RowLimit：<RowLimit>10</RowLimit> 查询结果的返回行限制 

ViewFields：<ViewFields> <FieldRef Name='Title'/> <FieldRef Name='Name'/></ViewFields>查询结果要显示的字段 

2. 查询条件 

query.Query = "<Where><Eq><FieldRef Name='Status'/>" + "<Value Type='Text'>Completed</Value></Eq></Where>";

2.1.比较操作符如下：

2.2.Or

.<Where> <Or> <Geq><FieldRef Name='Field1'/> <Value Type='Number'>1500</Value> </Geq> <Leq> <FieldRef Name='Field2'/><Value Type='Number'>500</Value> </Leq> </Or> </Where>

2.3.And

<Where> <And> <BeginsWith> <FieldRef Name="Conference"/> <Value Type="Note">Morning</Value> </BeginsWith> <Contains> <FieldRef Name="Conference" /> <Value Type="Note">discussion session</Value> </Contains> </And></Where>

2.4.Orderby

<OrderBy>

<FieldRef Name="Modified" Ascending="FALSE"></FieldRef>

</OrderBy>

2.5.GroupBy

<GroupBy>

<FieldRef Name="Modified"/>

</GroupBy>

3.转义

例:

<FieldRef Name=\"Checkbox\"></FieldRef> <Value Type=\"bit\">1</Value>

4.Batch

内嵌于 HTTP 协议中，Batch 元素必须至少包含一个 Method 元素。Batch 元素允许客户端应用程序一次性向服务器传送多个命令。

4.1.格式

<Batch

OnError = "Return" | "Continue"

ListVersion = ""

Version = ""

ViewName = "">

<Method>

...

</Method>

...

</Batch>

4.2.Method：在批处理中用于指定 Batch 元素中的命令。 

Method 元素是 Batch 元素所必需的

<Method ID="Text"

Cmd = "Text"

ID = "Text">

</Method>

4.3. SetList：指定当前正在使用的列表。

<SetList

Name = "Text"

PreserveContext = "TRUE" | "FALSE"

Scope = "Request">

</SetList>

4.4. SetVar：允许在本地将页呈现到当前 XML 级别或将页全局呈现到页的上下文中设置变量。

<SetVar

ID = "Text"

Name = "Text"

Scope = "Request"

Value = "Text">

</SetVar>

在下面的示例中，第一个 GetVar 元素返回“Value_2”，第二个 GetVar 元素返回“Value_1”，因为包含“Value_2”的 SetVar 元素仅适用于“Sample”元素的子级。“Value_2”在“Sample”结束标记之后超出范围。

XML

<SetVar Name="myVar">Value_1</SetVar>

<Sample>

<SetVar Name="myVar">Value_2</SetVar>

<GetVar Name="myVar"/>

</Sample>

<GetVar Name="myVar"/>

4.5.例子

batchElement.InnerXml = "<Method ID='1' Cmd='Update'>" +

"<Field Name='ID'>6</Field>" +

"<Field Name='Title'>Modified sixth item</Field></Method>" +

"<Method ID='2' Cmd='Update'><Field Name='ID'>7</Field>" +

"<Field Name='Title'>Modified seventh item</Field></Method>" +

"<Method ID='3' Cmd='Delete'><Field Name='ID'>5</Field>" +

"</Method><Method ID='4' Cmd='New'>" +

"<Field Name='Title'>Added item</Field></Method>";

5.WSS中的各种字段类型与.NET中对应的数据类型的对照关系