CalendarView

  • Artikel

Das CalendarView-Element definiert einen FindItem-Vorgang als Rückgabe von Kalenderelementen in einer Gruppe, wie sie in einem Kalender angezeigt werden.

FindItem

CalendarView

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

CalendarView

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut Beschreibung
MaxEntriesReturned
Beschreibt die maximale Anzahl von Ergebnissen, die in der FindItem-Antwort zurückgegeben werden sollen.
StartDate
Gibt den Anfang einer nach Kalenderelementen abgefragten Zeitspanne an. Alle Kalenderelemente, deren Endzeit vor StartDate liegt, werden nicht zurückgegeben. Der Wert von StartDate kann im UTC-Format (Coordinated Universal Time) angegeben werden, wie in 2006-01-02T12:00:00Z, oder in einem Format, in dem lokale Zeit und Zeitzonenoffset angegeben werden, wie in 2006-01-02T04:00:00-08:00.

Dieses Attribut ist erforderlich.
EndDate
Gibt das Ende einer nach Kalenderelementen abgefragten Zeitspanne an. Alle Kalenderelemente mit einer Startzeit, die am oder nach EndDate liegt, werden nicht zurückgegeben. Der Wert von EndDate kann im UTC-Format angegeben werden, wie in 2006-02-02T12:00:00Z, oder in einem Format, in dem lokale Uhrzeit und Zeitzonenoffset angegeben sind, wie in 2006-02-02T04:00:00-08:00.

EndDate muss größer oder gleich StartDate sein; andernfalls wird ein Fehler zurückgegeben. Dieses Attribut ist erforderlich.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element Beschreibung
FindItem
Definiert eine Anforderung zum Suchen von Elementen in einem Postfach.

Für dieses Element wird folgender XPath-Ausdruck verwendet:
/FindItem

HinwBemerkungeneise

Wenn das CalendarView-Element in einer FindItem-Anforderung angegeben wird, gibt der Webdienst eine Liste einzelner Kalenderelemente und vorkommen wiederkehrender Kalenderelemente innerhalb des durch StartDate und EndDate angegebenen Bereichs zurück.

Wenn das CalendarView-Element in einer FindItem-Anforderung nicht angegeben ist, gibt der Webdienst eine Liste einzelner Kalenderelemente und wiederkehrender Masterkalenderelemente zurück. Kalenderereignisse eines wiederkehrenden Kalenderelements werden nicht erweitert.

CalendarView-Abfragen sollten nur die folgenden Eigenschaften verwenden, da sie schnellere Kalenderabfragen unterstützen.

Wiederholungsblobeigenschaften

  • MapiStartTime

  • MapiEndTime

  • SubjectPrefixInternal

  • NormalizedSubjectInternal

  • MapiSubject

  • Standort

  • AppointmentColor

  • MapiIsAllDayEvent

  • MapiHasAttachment

  • FreeBusyStatus

  • ReminderIsSetInternal

  • ReminderMinutesBeforeStartInternal

  • AppointmentState

  • AllAttachmentsHidden

  • ChangeHighlight

Berechnet aus dem primären Wiederholungsblob oder Master

  • ItemId

  • IsRecurring

  • IsException

  • AppointmentRecurring

  • MapiStartTime

  • MapiPRStartDate

  • MapiEndTime

  • MapiPREndDate

  • CalendarItemType

  • GlobalObjectId

  • TimeZoneDefinitionStart

  • TimeZoneDefinitionEnd

Eigenschaften von Masterkalenderelementen

  • EntryId

  • ChangeKey

  • ItemClass

  • SentRepresentingEmailAddress

  • SentRepresentingDisplayName

  • SentRepresentingEntryId

  • AppointmentRecurrenceBlob

  • TimeZone

  • TimeZoneBlob

  • TimeZoneDefinitionRecurring

  • CleanGlobalObjectId

  • AppointmentRecurring

  • IsException

  • IsRecurring

  • MapiSensitivity

  • ContainerClass

  • MapiPRStartDate

  • MapiPREndDate

  • Categories

Das Schema, das dieses Element beschreibt, befindet sich im virtuellen IIS-Verzeichnis, das Exchange-Webdienste hostet.

Beispiel

Das folgende Beispiel zeigt eine FindItem-Anforderung. Eine erfolgreiche Anforderung gibt eine Antwort zurück, die Kalenderelemente enthält, die bei 2006-05-18T00:00:00-08:00 oder nach dem 2006-05-19T00:00:00-08:00 endeten.

<?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>

Informationen zu Elementen

Element Beispiel
Namespace
 https://schemas.microsoft.com/exchange/services/2006/messages
Name des Schemas
 Nachrichtenschema
Überprüfungsdatei
 Messages.xsd
Leer kann sein
 False

Siehe auch