QueryString (QueryStringType)

QueryString 元素包含基于高级查询语法 (AQS) 的邮箱查询字符串。

<QueryString/>

QueryStringType

属性和元素

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

Attributes

属性 说明
ResetCache
指示应重置缓存。
ReturnDeletedItems
指示应返回已删除的项目。
ReturnHighlightTerms
指示应返回突出显示的术语。

子元素

无。

父元素

元素 说明
FindItem
定义在邮箱中查找项目的请求。
下面是此元素的 XPath 表达式:/FindItem。

文本值

QueryString 元素文本值表示使用高级查询语法 (AQS) 子集进行的邮箱查询。 有关查询字符串支持的语法选项的信息,请参阅备注部分。

备注

在 Exchange Server 2010 中,此元素是 XML 架构字符串类型。 在从 Exchange Server 2013 开始的 Exchange 版本(包括 Exchange Online)中,此元素的类型为 QueryStringType。 此更改不会中断任何现有客户端,因为它添加了三个新的可选属性。

QueryString 元素不包括使用 EWS 限制。 EWS 中的 AQS 支持三种类型的限制:关键字限制、日期范围限制和消息类型限制。 下表列出了每种限制类型支持的搜索属性。

关键字限制

属性 示例 函数
起始数量
发件人:Dean
发件人:“Dean Halstead”
搜索从 Dean 发送的项目。
搜索从 Dean Halstead 发送的项目。 发件人必须正好是“Dean Halstead”。
更改为
收件人:Dean
搜索收件人为 Dean 的项目。
cc
抄送:Dean
搜索抄送行包含 Dean 的项目。
bcc
密件抄送:Dean
搜索密件抄送行包含 Dean 的项目。
参与者
参与者:Dean
搜索收件人、抄送或密件抄送字段中包含 Dean 的项目。
主题
主题:产品
主题:(产品开发)
主题:“产品开发”
搜索主题中包含产品的项目。
搜索主题中包含产品和开发的项目。
正文
内容
正文:进度
内容:进度
搜索正文中包含进度的项目。
Attachment
附件:报告
搜索附件文件名或文件正文中包含报告的项目。
(属性未指定)
产品开发
搜索所有关键字属性中同时包含产品和开发的项目。

关键字限制匹配始终不区分大小写。 关键字限制支持两种匹配类型:前缀匹配或完全匹配。 前缀匹配是默认匹配行为。 如果需要完全匹配,请使用双引号。 例如,主题:“产品”与主题中的“产品”匹配,但不匹配“生产”。 双引号中的多个文字限制关键字及其顺序。 例如,“win 产品”仅与“win 产品”匹配,不匹配“win95 产品”或“win 的产品”。 可以使用星号 (*) 来定义顺序受限的前缀匹配项。 例如,“win product”* 匹配“win95 产品”、“windows 生产线”,但与“windows new product”或“win 产品”匹配。 可以搜索从某个域发送或发送到某个域的所有邮件。 例如,发件人:“@hotmail.com”返回从 hotmail.com 邮件发送的所有邮件。

下表介绍了日期范围限制。

日期范围限制

属性 示例 函数
发件箱
发送时间:上周
发送时间:2001 年 1 月 1 日
发送时间:2001 年 1 月 1 日..2001 年 1 月 15 日
搜索上周发送的项目。
搜索 2001 年 1 月 1 日发送的项目。
搜索在 2001 年 1 月 1 日到 2001 年 1 月 15 日之间发送的项目。
接收时间
接收时间:今天
接收时间:2001 年 1 月 1 日
搜索今天收到的项目。
搜索 2001 年 1 月 1 日收到的项目。

两个点 (..) 是一个范围运算符。 它可用于定义具有开始日期和结束日期的范围。 若要指定日期,可以使用相对日期。 支持以下相对日期:

  • 相对日期:今天、明天、昨天

  • 大范围相对日期:本周、下个月、上周、上个月或下一年

  • 天:星期日、星期一、星期二、星期三、星期四、星期五、星期六

  • 一月、二月、三月、四月、五月、六月、七月、八月、九月、十月、十一月、十二月

下表介绍了邮件类型限制。

邮件类型限制

属性 示例 函数
Kind
类型:任务
搜索所有任务项目。

EWS 中的 AQS 使用类型属性指定邮件类型。 类型属性可用于以下项目类型:

  • 电子邮件

  • 会议

  • tasks

  • notes

  • 文档

  • 日志

  • contacts

  • 即时消息

下表介绍了逻辑连接器的分组。

逻辑连接器的分组

Connector 示例 函数
AND
主题:产品 AND 主题:开发
主题:(产品 AND 开发)
主题:(产品开发)
搜索主题中同时包含产品和开发的项目。

正文:项目 OR 正文:建议
正文:(项目或建议)
搜索正文中包含产品或建议的项目。
NOT
NOT 正文:建议
正文:(NOT 建议)
搜索正文中不含建议的邮件。

AND 始终是默认连接器。 例如,“主题:项目 AND 主题:建议”与“主题:项目 主题:建议”相同。 逻辑连接器区分大小写。 例如,正文:(项目 Or 建议)搜索正文中包含“项目”、“or”和“建议”的邮件,而不是“项目”或“建议”。 加号 (+) 等效于 AND。 连字符 (-) 等效于 NOT。 例如,正文:(项目 - 建议)搜索正文中包含“项目”但不包含“建议”的邮件。

查询字符串还可以包含未索引属性进行搜索。 如果查询字符串包含非索引属性,则搜索可能会对索引属性执行 Exchange 搜索,并对非索引属性执行存储搜索。

描述此元素的架构位于承载 Exchange Web Services 的 IIS 虚拟目录中。

示例

以下示例显示了在收件箱中搜索主题为“自动发现”的邮件的请求。

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2010" />
  </soap:Header>
  <soap:Body>
    <m:FindItem Traversal="Shallow">
      <m:ItemShape>
        <t:BaseShape>IdOnly</t:BaseShape>
        <t:AdditionalProperties>
          <t:FieldURI FieldURI="item:Subject" />
        </t:AdditionalProperties>
      </m:ItemShape>
      <m:IndexedPageItemView MaxEntriesReturned="1" Offset="0" BasePoint="Beginning" />
      <m:ParentFolderIds>
        <t:DistinguishedFolderId Id="inbox" />
      </m:ParentFolderIds>
      <m:QueryString>subject:Autodiscover</m:QueryString>
    </m:FindItem>
  </soap:Body>
</soap:Envelope>

下面的示例演示对请求的成功响应。

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:ServerVersionInfo MajorVersion="14" 
                         MinorVersion="0" 
                         MajorBuildNumber="639" 
                         MinorBuildNumber="20" 
                         Version="Exchange2010" 
                         xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                         xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <m:FindItemResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                        xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
      <m:ResponseMessages>
        <m:FindItemResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:RootFolder IndexedPagingOffset="1" 
                        TotalItemsInView="5" 
                        IncludesLastItemInRange="false">
            <t:Items>
              <t:Message>
                <t:ItemId Id="AAMkADEzOTExYjJkLTYx" ChangeKey="CQAAABY" />
                <t:Subject>How to use Autodiscover</t:Subject>
              </t:Message>
            </t:Items>
          </m:RootFolder>
        </m:FindItemResponseMessage>
      </m:ResponseMessages>
    </m:FindItemResponse>
  </s:Body>
</s:Envelope>

元素信息

代码 名称
命名空间
http://schemas.microsoft.com/exchange/services/2006/messages
架构名称
消息架构
验证文件
Messages.xsd
可以为空
False

另请参阅

FindItem 操作

FindConversation 操作