Share via

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="https://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="https://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="https://schemas.microsoft.com/exchange/services/2006/types" 
                         xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/messages" 
                        xmlns:t="https://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>

元素信息

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

另请参阅

FindItem 操作

FindConversation 操作