where 元素 (查询)

适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

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

<Where>
</Where>

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

无

子元素

• And
• BeginsWith
• Contains
• DateRangesOverlap
• 情 商
• Geq
• 燃气轮机
• In
• 包括
• IsNotNull
• IsNull
• Leq
• Lt
• Membership
• Neq
• NotIncludes
• Or

父元素

• Expr1
• Expr2
• Query

出现次数

• 最小值：0
• 最大值：1

备注

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

Where 元素中引用的字段不必为查询的主列表的字段。 如果正在联接外部列表，则可以在 ProjectedFields 元素中逐项化外部列表中的字段，然后在 Where 元素中引用字段。

示例

在以下示例中， Where 元素使用 Geq 元素作为查询中的筛选器，返回 “过期” 字段中的日期和时间值大于当前日期和时间的情况。

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