CalendarView

CalendarView 元素将 FindItem 操作定义为在日历中显示时返回集中的日历项。

FindItem

CalendarView

<CalendarView MaxEntriesReturned="" StartDate="" EndDate="" />

CalendarView

属性和元素

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

Attributes

属性 说明
MaxEntriesReturned
描述在 FindItem 响应中返回的最大结果数。
StartDate
标识为日历项查询的时间跨度开始。 不会返回结束时间早于 StartDate 的所有日历项目。 StartDate 的值可以指定协调世界时 (UTC) 格式(如 2006-01-02T12:00:00Z)或指定本地时间和时区偏移量的格式(如 2006-01-02T04:00:00-08:00)。

此特性是必需的。
EndDate
标识为日历项查询的时间跨度结束。 不会返回开始时间在 EndDate 上或之后的所有日历项目。 EndDate 的值可以采用 UTC 格式(如 2006-02-02T12:00:00Z)或指定本地时间和时区偏移量的格式指定,如 2006-02-02T04:00:00-08:00。

EndDate 必须大于或等于 StartDate;否则将返回错误。 此特性是必需的。

子元素

无。

父元素

元素 说明
FindItem
定义在邮箱中查找项目的请求。

下面是此元素的 XPath 表达式:
/FindItem

备注

如果在 FindItem 请求中指定了 CalendarView 元素,则 Web 服务将返回 StartDateEndDate 指定的范围内的单个日历项目和定期日历项的列表。

如果未在 FindItem 请求中指定 CalendarView 元素,则 Web 服务将返回单个日历项目和定期主日历项目的列表。 不会展开定期日历项的日历匹配项。

CalendarView 查询应仅使用以下属性,因为它们支持更快的日历查询。

定期 Blob 属性

  • MapiStartTime

  • MapiEndTime

  • SubjectPrefixInternal

  • NormalizedSubjectInternal

  • MapiSubject

  • 位置

  • AppointmentColor

  • MapiIsAllDayEvent

  • MapiHasAttachment

  • freeBusyStatus

  • ReminderIsSetInternal

  • ReminderMinutesBeforeStartInternal

  • AppointmentState

  • AllAttachmentsHidden

  • ChangeHighlight

从主定期 Blob 或主数据库计算

  • ItemId

  • IsRecurring

  • IsException

  • AppointmentRecurring

  • MapiStartTime

  • MapiPRStartDate

  • MapiEndTime

  • MapiPREndDate

  • CalendarItemType

  • GlobalObjectId

  • TimeZoneDefinitionStart

  • TimeZoneDefinitionEnd

主日历项属性

  • EntryId

  • ChangeKey

  • ItemClass

  • SentRepresentingEmailAddress

  • SentRepresentingDisplayName

  • SentRepresentingEntryId

  • AppointmentRecurrenceBlob

  • TimeZone

  • TimeZoneBlob

  • TimeZoneDefinitionRecurring

  • CleanGlobalObjectId

  • AppointmentRecurring

  • IsException

  • IsRecurring

  • MapiSensitivity

  • ContainerClass

  • MapiPRStartDate

  • MapiPREndDate

  • 类别

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

示例

以下示例显示了 FindItem 请求。 成功的请求返回一个响应,其中包括从 2006-05-18T00:00:00-08:00 开始或在 2006-05-19T00:00:00-08:00 之前结束的日历项。

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindItem Traversal="Shallow" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ItemShape>
        <t:BaseShape>IdOnly</t:BaseShape>
        <t:AdditionalProperties>
          <t:FieldURI FieldURI="calendar:Start"/>
          <t:FieldURI FieldURI="calendar:End"/>
          <t:FieldURI FieldURI="item:Subject"/>
        </t:AdditionalProperties>
      </ItemShape>
      <CalendarView MaxEntriesReturned="2" StartDate="2006-05-18T00:00:00-08:00" EndDate="2006-05-19T00:00:00-08:00"/>
      <ParentFolderIds>
        <t:DistinguishedFolderId Id="calendar"/>
      </ParentFolderIds>
    </FindItem>
  </soap:Body>
</soap:Envelope>

元素信息

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

另请参阅