AppendToItemField

Last modified: March 16, 2009

Applies to: Exchange Server 2007 | Exchange Server 2010

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

UpdateItem
  ItemChanges
    ItemChange
      Updates (Item)
        AppendToItemField

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

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

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

See Also

Reference

Other Resources