通过

Where 元素（查询）

  • 项目

上次修改时间： 2015年3月9日

适用范围： SharePoint Foundation 2010

本文内容
属性
子元素
父元素
出现次数

在查询上下文中用来指定筛选器。

<Where>
</Where>

属性

属性

说明

无

N/A

子元素

And、BeginsWith、Contains、DateRangesOverlap、Eq、Geq、Gt、In、Includes、IsNotNull、IsNull、Leq、Lt、Membership、Neq、NotIncludes、Or

父元素

Expr1、Expr2、Query

出现次数

最少：0 次

最多：1 次

备注

Where 子句转换为 SQL SELECT 语句。Where 子句的格式为结构化 XML 树，其中混合了比较运算符、简单算术运算符、字段（列）引用、常量值以及预定义协作应用程序标记语言 (CAML) 常量。

Where 元素中引用的字段不必为查询的主列表的字段。如果联接了外部列表，则可以在 ProjectedFields 元素中详细列出外部列表中的字段，然后可以在 Where 元素中引用这些字段。

示例

在下面的示例中，Where 元素使用 Geq 元素作为查询中的筛选器，返回 Expires 字段中的日期和时间值超过今天的日期和时间的情况。

<Query>
  <Where>
    <Geq>
      <FieldRef Name="Expires"/>
      <Value Type="DateTime">
        <Today/>
      </Value>
    </Geq>
  </Where>
  <OrderBy>
    <FieldRef Name="Modified"/>
  </OrderBy>
</Query>