CalendarView

项目
03/29/2023

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

<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 服务将返回 StartDate 和 EndDate 指定的范围内的单个日历项目和定期日历项的列表。

如果未在 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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindItem Traversal="Shallow" xmlns="https://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>

元素信息

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

通过