CalendarViewCalendarView

L’élément CalendarView définit une opération FindItem comme renvoyant des éléments de calendrier dans un jeu tel qu’ils apparaissent dans un calendrier.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

Attributs et élémentsAttributes and elements

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
MaxEntriesReturnedMaxEntriesReturned
Décrit le nombre maximal de résultats à renvoyer dans la réponse FindItem.Describes the maximum number of results to return in the FindItem response.
StartDateStartDate
Identifie le début d’un intervalle de temps interrogé pour les éléments de calendrier.Identifies the start of a time span queried for calendar items. Tous les éléments de calendrier dont l’heure de fin est antérieure à StartDate ne seront pas renvoyés.All calendar items that have an end time that is before StartDate will not be returned. La valeur de StartDate peut être spécifiée au format UTC (Coordinated Universal Time), en 2006-01-02T12:00:00Z, ou dans un format où l’heure locale et le décalage du fuseau horaire sont spécifiés, comme indiqué en 2006-01-02T04:00:00-08: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.

Cet attribut est obligatoire.This attribute is required.
EndDateEndDate
Identifie la fin d’un intervalle de temps interrogé pour les éléments de calendrier.Identifies the end of a time span queried for calendar items. Tous les éléments de calendrier dont l’heure de début est identique ou postérieure à la date d’expiration ne sont pas renvoyés.All calendar items that have a start time that is on or after EndDate will not be returned. La valeur de EndDate peut être spécifiée au format UTC, comme en 2006-02-02T12:00:00Z, ou dans un format où l’heure locale et le décalage du fuseau horaire sont spécifiés, comme indiqué en 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.

La date de fin doit être supérieure ou égale à ladate de début ; Sinon, une erreur est renvoyée.EndDate must be greater than or equal to StartDate; otherwise an error is returned. Cet attribut est obligatoire.This attribute is required.

Éléments enfantsChild elements

Aucun.None.

Éléments parentsParent elements

ÉlémentElement DescriptionDescription
FindItemFindItem
Définit une requête pour rechercher des éléments dans une boîte aux lettres.Defines a request to find items in a mailbox.

Voici l’expression XPath de cet élément :The following is the XPath expression to this element:
/FindItem

RemarquesRemarks

Si l’élément CalendarView est spécifié dans une demande FindItem, le service Web renvoie une liste d’éléments de calendrier uniques et d’occurrences d’éléments de calendrier périodiques dans la plage spécifiée par StartDate et EndDate.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.

Si l’élément CalendarView n’est pas spécifié dans une demande FindItem, le service Web renvoie une liste des éléments de calendrier uniques et des éléments de calendrier principal périodiques.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. Les occurrences de calendrier d’un élément de calendrier périodique ne sont pas développées.Calendar occurrences of a recurring calendar item are not expanded.

Les requêtes CalendarView doivent uniquement utiliser les propriétés suivantes, car elles prennent en charge des requêtes de calendrier plus rapides.CalendarView queries should only make use of the following properties since they support faster calendar queries.

Propriétés de l’objet blob de récurrenceRecurrence blob properties

  • MapiStartTimeMapiStartTime

  • MapiEndTimeMapiEndTime

  • SubjectPrefixInternalSubjectPrefixInternal

  • NormalizedSubjectInternalNormalizedSubjectInternal

  • MapiSubjectMapiSubject

  • EmplacementLocation

  • AppointmentColorAppointmentColor

  • MapiIsAllDayEventMapiIsAllDayEvent

  • MapiHasAttachmentMapiHasAttachment

  • FreeBusyStatusFreeBusyStatus

  • ReminderIsSetInternalReminderIsSetInternal

  • ReminderMinutesBeforeStartInternalReminderMinutesBeforeStartInternal

  • AppointmentStateAppointmentState

  • AllAttachmentsHiddenAllAttachmentsHidden

  • ChangeHighlightChangeHighlight

Calculé à partir de l’objet blob de récurrence principale ou de la forme de baseCalculated from the primary recurrence blob or master

  • ItemIdItemId

  • IsRecurringIsRecurring

  • IsExceptionIsException

  • AppointmentRecurringAppointmentRecurring

  • MapiStartTimeMapiStartTime

  • MapiPRStartDateMapiPRStartDate

  • MapiEndTimeMapiEndTime

  • MapiPREndDateMapiPREndDate

  • CalendarItemTypeCalendarItemType

  • GlobalObjectIdGlobalObjectId

  • TimeZoneDefinitionStartTimeZoneDefinitionStart

  • TimeZoneDefinitionEndTimeZoneDefinitionEnd

Propriétés de l’élément de calendrier principalMaster calendar item properties

  • EntréeEntryId

  • ChangeKeyChangeKey

  • ItemClassItemClass

  • SentRepresentingEmailAddressSentRepresentingEmailAddress

  • SentRepresentingDisplayNameSentRepresentingDisplayName

  • SentRepresentingEntryIdSentRepresentingEntryId

  • AppointmentRecurrenceBlobAppointmentRecurrenceBlob

  • TimeZoneTimeZone

  • TimeZoneBlobTimeZoneBlob

  • TimeZoneDefinitionRecurringTimeZoneDefinitionRecurring

  • CleanGlobalObjectIdCleanGlobalObjectId

  • AppointmentRecurringAppointmentRecurring

  • IsExceptionIsException

  • IsRecurringIsRecurring

  • MapiSensitivityMapiSensitivity

  • ContainerClassContainerClass

  • MapiPRStartDateMapiPRStartDate

  • MapiPREndDateMapiPREndDate

  • CatégoriesCategories

Le schéma qui décrit cet élément se trouve dans le répertoire virtuel IIS qui héberge les services web Exchange.The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

ExempleExample

L’exemple suivant montre une requête FindItem.The following example shows a FindItem request. Une demande réussie renvoie une réponse qui inclut des éléments de calendrier démarrés à 2006-05-18T00:00:00-08:00 ou après et s’est terminé avant 2006-05-19T00: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>

Informations sur l'élémentElement information

Espace de nomsNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
Nom du schémaSchema Name
Schéma MessagesMessages schema
Fichier de validationValidation File
Messages. xsdMessages.xsd
Peut être videCan be Empty
FalseFalse

Voir aussiSee also