Article
08/21/2009

AppendToItemField

Topic Last Modified: 2008-08-18

The AppendToItemField element identifies data to append to a single property of an item during an UpdateItem Operation.

Schema Hierarchy

UpdateItem
  ItemChanges
    ItemChange
      Updates (Item)
        AppendToItemField

Syntax

<AppendToItemField>
   <FieldURI/>
   <Item/>
</AppendToItemField>

<AppendToItemField>
   <FieldURI/>
   <Message/>
</AppendToItemField>

<AppendToItemField>
   <FieldURI/>
   <CalendarItem/>
</AppendToItemField>

<AppendToItemField>
   <FieldURI/>
   <Contact/>
</AppendToItemField>

<AppendToItemField>
   <FieldURI/>
   <DistributionList/>
</AppendToItemField>

<AppendToItemField>
   <FieldURI/>
   <MeetingMessage/>
</AppendToItemField>

<AppendToItemField>
   <FieldURI/>
   <MeetingRequest/>
</AppendToItemField>

<AppendToItemField>
   <FieldURI/>
   <MeetingResponse/>
</AppendToItemField>

<AppendToItemField>
   <FieldURI/>
   <MeetingCancellation/>
</AppendToItemField>

<AppendToItemField>
   <FieldURI/>
   <Task/>
</AppendToItemField>

<AppendToItemField>
   <IndexedFieldURI/>
   <Item/>
</AppendToItemField>

<AppendToItemField>
   <IndexedFieldURI/>
   <Message/>
</AppendToItemField>

<AppendToItemField>
   <IndexedFieldURI/>
   <CalendarItem/>
</AppendToItemField>

<AppendToItemField>
   <IndexedFieldURI/>
   <Contact/>
</AppendToItemField>

<AppendToItemField>
   <IndexedFieldURI/>
   <DistributionList/>
</AppendToItemField>

<AppendToItemField>
   <IndexedFieldURI/>
   <MeetingMessage/>
</AppendToItemField>

<AppendToItemField>
   <IndexedFieldURI/>
   <MeetingRequest/>
</AppendToItemField>

<AppendToItemField>
   <IndexedFieldURI/>
   <MeetingResponse/>
</AppendToItemField>

<AppendToItemField>
   <IndexedFieldURI/>
   <MeetingCancellation/>
</AppendToItemField>

<AppendToItemField>
   <IndexedFieldURI/>
   <Task/>
</AppendToItemField>

<AppendToItemField>
   <ExtendedFieldURI/>
   <Item/>
</AppendToItemField>

<AppendToItemField>
   <ExtendedFieldURI/>
   <Message/>
</AppendToItemField>

<AppendToItemField>
   <ExtendedFieldURI/>
   <CalendarItem/>
</AppendToItemField>

<AppendToItemField>
   <ExtendedFieldURI/>
   <Contact/>
</AppendToItemField>

<AppendToItemField>
   <ExtendedFieldURI/>
   <DistributionList/>
</AppendToItemField>

<AppendToItemField>
   <ExtendedFieldURI/>
   <MeetingMessage/>
</AppendToItemField>

<AppendToItemField>
   <ExtendedFieldURI/>
   <MeetingRequest/>
</AppendToItemField>

<AppendToItemField>
   <ExtendedFieldURI/>
   <MeetingResponse/>
</AppendToItemField>

<AppendToItemField>
   <ExtendedFieldURI/>
   <MeetingCancellation/>
</AppendToItemField>

<AppendToItemField>
   <ExtendedFieldURI/>
   <Task/>
</AppendToItemField>

Type

AppendToItemFieldType

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element	Description
FieldURI	Identifies frequently referenced properties by URI.
IndexedFieldURI	Identifies individual members of a dictionary.
ExtendedFieldURI	Identifies extended MAPI properties to append.
Item	Represents an item in the Exchange store.
Message	Represents an Exchange e-mail message.
CalendarItem	Represents an Exchange calendar item.
Contact	Represents an Exchange contact item.
DistributionList	Represents a distribution list.
MeetingMessage	Represents a meeting in the Exchange store.
MeetingResponse	Represents a meeting response in the Exchange store.
MeetingRequest	Represents a meeting request in the Exchange store.
MeetingCancellation	Represents a meeting cancellation in the Exchange store.
Task	Represents a task in the Exchange store.

Parent Elements

Element Description

Element	Description
Updates (Item)	Contains an array that defines append, set, and delete changes to item properties. The following is the XPath expression to this element: `/UpdateItem/ItemChanges/ItemChange[i]/Updates`

Updates (Item)

Contains an array that defines append, set, and delete changes to item properties.

The following is the XPath expression to this element: /UpdateItem/ItemChanges/ItemChange[i]/Updates

Remarks

Only certain properties support append operations. An attempt to append to a property that does not support appending will result in an error.

For update operations, only one property can be modified within a single request. That single property must be referenced in the Path element. The Item element in the derived classes can then only hold a single property that is in agreement with the single Path element.

Note

The Path element is abstract. It must be substituted by the FieldURI, IndexedFieldURI, or ExtendedFieldURI element.

The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.

Element Information

Namespace	https://schemas.microsoft.com/exchange/services/2006/types
Schema Name	Types schema
Validation File	Types.xsd
Can be Empty	False

Partager via