CalendarViewCalendarView

CalendarView元素将FindItem 操作定义为返回日历中显示的日历项目。The CalendarView element defines a FindItem operation as returning calendar items in a set as they appear in a calendar.

FindItemFindItem

CalendarViewCalendarView

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

CalendarViewCalendarView

属性和元素Attributes and elements

下面各部分介绍了属性、子元素和父元素。The following sections describe attributes, child elements, and parent elements.

AttributesAttributes

属性Attribute 说明Description
MaxEntriesReturnedMaxEntriesReturned
描述在 FindItem 响应中返回的最大结果数。Describes the maximum number of results to return in the FindItem response.
StartDateStartDate
标识为日历项目查询的时间范围的开始时间。Identifies the start of a time span queried for calendar items. 将不返回开始日期前结束时间的所有日历项目。All calendar items that have an end time that is before StartDate will not be returned. 开始日期值可以指定为协调世界时(UTC)格式,如 2006-01-02T12:00:00Z,或以指定本地时间和时区偏移量的格式(如 2006-01-02T04:00:00:00:00:00:00:00:00:00:00)。The value of StartDate can be specified in coordinated universal time (UTC) format, as in 2006-01-02T12:00:00Z, or in a format where local time and time zone offset is specified, as in 2006-01-02T04:00:00-08:00.

此特性是必需的。This attribute is required.
EndDateEndDate
标识为日历项目查询的时间范围的结束时间。Identifies the end of a time span queried for calendar items. 将不返回开始时间或结束时间结束的所有日历项目。All calendar items that have a start time that is on or after EndDate will not be returned. 结束日期的值可以指定为 UTC 格式,如 2006-02-02T12:00:00Z,或以指定本地时间和时区偏移量的格式(如 2006-02-02T04:00: 00-08:00中所示)。The value of EndDate can be specified in UTC format, as in 2006-02-02T12:00:00Z, or in a format where local time and time zone offset is specified, as in 2006-02-02T04:00:00-08:00.

结束日期必须大于或等于开始日期;否则,将返回错误。EndDate must be greater than or equal to StartDate; otherwise an error is returned. 此特性是必需的。This attribute is required.

子元素Child elements

无。None.

父元素Parent elements

元素Element 说明Description
FindItemFindItem
定义在邮箱中查找项目的请求。Defines a request to find items in a mailbox.

下面是此元素的 XPath 表达式: The following is the XPath expression to this element:
/FindItem

备注Remarks

如果在 FindItem 请求中指定了CalendarView元素,则 Web 服务将在起始日期结束日期指定的范围内返回单个日历项目和定期日历项目的匹配项的列表。If the CalendarView element is specified in a FindItem request, the Web service returns a list of single calendar items and occurrences of recurring calendar items within the range specified by StartDate and EndDate.

如果 FindItem 请求中未指定CalendarView元素,则 Web 服务将返回单个日历项目和定期主日历项目的列表。If the CalendarView element is not specified in a FindItem request, the Web service returns a list of single calendar items and recurring master calendar items. 不展开定期日历项目的日历事件。Calendar occurrences of a recurring calendar item are not expanded.

CalendarView 查询应仅使用下列属性,因为它们支持更快的日历查询。CalendarView queries should only make use of the following properties since they support faster calendar queries.

定期 blob 属性Recurrence blob properties

  • MapiStartTimeMapiStartTime

  • MapiEndTimeMapiEndTime

  • SubjectPrefixInternalSubjectPrefixInternal

  • NormalizedSubjectInternalNormalizedSubjectInternal

  • MapiSubjectMapiSubject

  • 位置Location

  • AppointmentColorAppointmentColor

  • MapiIsAllDayEventMapiIsAllDayEvent

  • MapiHasAttachmentMapiHasAttachment

  • FreeBusyStatusFreeBusyStatus

  • ReminderIsSetInternalReminderIsSetInternal

  • ReminderMinutesBeforeStartInternalReminderMinutesBeforeStartInternal

  • AppointmentStateAppointmentState

  • AllAttachmentsHiddenAllAttachmentsHidden

  • ChangeHighlightChangeHighlight

通过主定期 blob 或主机计算Calculated from the primary recurrence blob or master

  • ItemIdItemId

  • IsRecurringIsRecurring

  • IsExceptionIsException

  • AppointmentRecurringAppointmentRecurring

  • MapiStartTimeMapiStartTime

  • MapiPRStartDateMapiPRStartDate

  • MapiEndTimeMapiEndTime

  • MapiPREndDateMapiPREndDate

  • CalendarItemTypeCalendarItemType

  • GlobalObjectIdGlobalObjectId

  • TimeZoneDefinitionStartTimeZoneDefinitionStart

  • TimeZoneDefinitionEndTimeZoneDefinitionEnd

主日历项目属性Master calendar item properties

  • EntryIdEntryId

  • ChangeKeyChangeKey

  • ItemClassItemClass

  • SentRepresentingEmailAddressSentRepresentingEmailAddress

  • SentRepresentingDisplayNameSentRepresentingDisplayName

  • SentRepresentingEntryIdSentRepresentingEntryId

  • AppointmentRecurrenceBlobAppointmentRecurrenceBlob

  • TimeZoneTimeZone

  • TimeZoneBlobTimeZoneBlob

  • TimeZoneDefinitionRecurringTimeZoneDefinitionRecurring

  • CleanGlobalObjectIdCleanGlobalObjectId

  • AppointmentRecurringAppointmentRecurring

  • IsExceptionIsException

  • IsRecurringIsRecurring

  • MapiSensitivityMapiSensitivity

  • ContainerClassContainerClass

  • MapiPRStartDateMapiPRStartDate

  • MapiPREndDateMapiPREndDate

  • 类别Categories

描述此元素的架构位于承载 Exchange Web Services 的 IIS 虚拟目录中。The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

示例Example

下面的示例展示了一个 FindItem 请求。The following example shows a FindItem request. 成功的请求将返回一个响应,其中包括在2006年-18T00:00:00:00:00:00:00:00:00:00:00:00:00:00:00: 00-08:00之前开始的日历项目。A successful request returns a response that includes calendar items that started at 2006-05-18T00:00:00-08:00 or after and ended before 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>

元素信息Element information

命名空间Namespace
https://schemas.microsoft.com/exchange/services/2006/messages
架构名称Schema Name
消息架构Messages schema
验证文件Validation File
Messages.xsdMessages.xsd
可以为空Can be Empty
FalseFalse

另请参阅See also