CalendarView

  • Статья

Элемент CalendarView определяет операцию FindItem как возвращающую элементы календаря в наборе по мере их появления в календаре.

FindItem

CalendarView

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

CalendarView

Атрибуты и элементы

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут Описание
MaxEntriesReturned
Описывает максимальное количество результатов, возвращаемых в ответе FindItem.
StartDate
Определяет начало периода времени, запрашиваемого для элементов календаря. Не будут возвращены все элементы календаря с временем окончания, предшествующим startDate . Значение StartDate можно указать в формате UTC, как в 2006-01-02T12:00:00Z, или в формате, в котором указано смещение местного времени и часового пояса, как в 2006-01-02T04:00:00-08:00.

Этот атрибут является обязательным.
EndDate
Определяет конец интервала времени, запрашиваемого для элементов календаря. Не будут возвращены все элементы календаря с временем начала или после него . Значение EndDate можно указать в формате UTC, как в 2006-02-02T12:00:00Z, или в формате, где указано смещение местного времени и часового пояса, как в 2006-02-02T04:00:00-08:00.

Значение EndDate должно быть больше или равно НачальнойDate; в противном случае возвращается ошибка. Этот атрибут является обязательным.

Дочерние элементы

Нет.

Родительские элементы

Элемент Описание
FindItem
Определяет запрос на поиск элементов в почтовом ящике.

Ниже приведено выражение XPath к этому элементу:
/FindItem

Замечания

Если элемент CalendarView указан в запросе FindItem, веб-служба возвращает список отдельных элементов календаря и вхождений повторяющихся элементов календаря в диапазоне, заданном в параметрах StartDate и EndDate.

Если элемент CalendarView не указан в запросе FindItem, веб-служба возвращает список отдельных элементов календаря и повторяющихся элементов главного календаря. Вхождения повторяющегося элемента календаря не разворачиваются.

Запросы 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

  • Categories

Схема, описывающая этот элемент, находится в виртуальном каталоге IIS, в котором размещены веб-службы Exchange.

Пример

В следующем примере показан запрос 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
Файл проверки
 Messages.xsd
Может быть пустым
 False

См. также