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.

属性Attributes

属性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. StartDateの値は協定世界時 (UTC) 形式で指定できます。2006年-01-02T12:00: 00z、または現地時刻とタイムゾーンオフセットが指定されている形式 (2006-01-02T12: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.

この属性は必須です。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. EndDateの値は、2006年-02-02T12:00: 00z のように UTC 形式で指定することができます。また、2006-02-02T12: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.

EndDateStartDate以上である必要があります。それ以外の場合は、エラーが返されます。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

CalendarView要素が FindItem 要求で指定されている場合、Web サービスは、開始日と終了日で指定された範囲内の予定表アイテムの1つおよび定期的なアイテムのリストを返します。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.

CalendarView要素が FindItem 要求で指定されていない場合、Web サービスは、1つの予定表アイテムと定期的なマスター予定表アイテムの一覧を返します。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

  • ChangeHighlight 表示ChangeHighlight

主要な定期的なアイテムの 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

  • [文] 表示 DisplaynameSentRepresentingDisplayName

  • [文]SentRepresentingEntryId

  • AppointmentRecurrenceBlobAppointmentRecurrenceBlob

  • TimeZoneTimeZone

  • TimeZoneBlobTimeZoneBlob

  • TimeZoneDefinitionRecurringTimeZoneDefinitionRecurring

  • CleanGlobalObjectIdCleanGlobalObjectId

  • AppointmentRecurringAppointmentRecurring

  • IsExceptionIsException

  • IsRecurringIsRecurring

  • MapiSensitivityMapiSensitivity

  • ContainerClassContainerClass

  • MapiPRStartDateMapiPRStartDate

  • MapiPREndDateMapiPREndDate

  • カテゴリCategories

この要素を記述するスキーマは、Exchange Web サービスをホストする 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年-05-18T00:00:00-08:00 または after and 終了された予定表アイテムを含む応答を返します。これは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>

要素の情報Element information

NamespaceNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
スキーマ名Schema Name
メッセージスキーマMessages schema
検証ファイルValidation File
メッセージ .xsdMessages.xsd
空に設定可能Can be Empty
正しくないFalse

関連項目See also