Message

Topic Last Modified: 2009-07-17

The Message element represents an Exchange e-mail message or non-IPM.Note item.

Syntax

<Message>
   <MimeContent/>
   <ItemId/>
   <ParentFolderId/>
   <ItemClass/>
   <Subject/>
   <Sensitivity/>
   <Body/>
   <Attachments/>
   <DateTimeReceived/>
   <Size/>
   <Categories/>
   <Importance/>
   <InReplyTo/>
   <IsSubmitted/>
   <IsDraft/>
   <IsFromMe/>
   <IsResend/>
   <IsUnmodified/>
   <InternetMessageHeaders/>
   <DateTimeSent/>
   <DateTimeCreated/>
   <ResponseObjects/>
   <ReminderDueBy/>
   <ReminderIsSet/>
   <ReminderMinutesBeforeStart/>
   <DisplayCc/>
   <DisplayTo/>
   <HasAttachments/>
   <ExtendedProperty/>
   <Culture/>
   <Sender/>
   <ToRecipients/>
   <CcRecipients/>
   <BccRecipients/>
   <IsReadReceiptRequested/>
   <IsDeliveryReceiptRequested/>
   <ConversationIndex/>
   <ConversationTopic/>
   <From/>
   <InternetMessageId/>
   <IsRead/>
   <IsResponseRequested/>
   <References/>
   <ReplyTo/>
   <EffectiveRights/>
   <ReceivedBy/>
   <ReceivedRepresenting/>
</Message>

Type

MessageType

Attributes and Elements

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

Attributes

None.

Child Elements

Element Description

MimeContent

Contains the native Multipurpose Internet Mail Extensions (MIME) stream of an object that is represented in base64Binary format.

ItemId

Contains the unique identifier and change key of an item in the Exchange store. This property is read-only.

ParentFolderId

Represents the identifier of the parent folder that contains the item or folder. This property is read-only.

ItemClass

Represents the message class of an item.

Subject

Represents the subject for Exchange store items and response objects. The subject is limited to 255 characters.

Sensitivity

Indicates the sensitivity level of an item.

Body

Represents the actual body content of a message.

Attachments

Contains the items or files that are attached to an item in the Exchange store.

DateTimeReceived

Represents the date and time that an item in a mailbox was received.

Size

Represents the size in bytes of an item. This property is read-only.

Categories

Represents a collection of strings that identify to which categories an item in the mailbox belongs.

Importance

Describes the importance of an item.

InReplyTo

Represents the identifier of the item to which this item is a reply.

IsSubmitted

Indicates whether an item has been submitted to the Outbox default folder.

IsDraft

Represents whether an item has not yet been sent.

IsFromMe

Indicates whether a user sent an item to him or herself.

IsResend

Indicates whether the item had previously been sent.

IsUnmodified

Indicates whether the item has been modified.

InternetMessageHeaders

Represents the collection of all Internet message headers that are contained within an item in a mailbox.

DateTimeSent

Represents the date and time that an item in a mailbox was sent.

DateTimeCreated

Represents the date and time that a given item in the mailbox was created.

ResponseObjects

Contains a collection of all the response objects that are associated with an item in the Exchange store.

ReminderDueBy

Represents the date and time when the event occurs. This is used by the ReminderMinutesBeforeStart element to determine when the reminder is displayed.

ReminderIsSet

Indicates whether a reminder has been set for an item in the Exchange store.

ReminderMinutesBeforeStart

Represents the number of minutes before an event when a reminder is displayed.

DisplayCc

Represents the display string that is used for the contents of the CC line. This is the concatenated string of all CC recipient display names.

DisplayTo

Represents the display string that is used for the contents of the To box. This is the concatenated string of all To recipient display names.

HasAttachments

Represents a property that is set to true if an item has at least one visible attachment. This property is read-only.

ExtendedProperty

Identifies extended properties on folders and items.

Culture

Represents the culture for a given item in a mailbox.

Sender

Identifies the sender of an item.

ToRecipients

Contains a set of recipients of a message.

CcRecipients

Represents a collection of recipients that will receive a copy of the message.

BccRecipients

Represents a collection of recipients to receive a blind carbon copy (Bcc) of an e-mail.

IsReadReceiptRequested

Indicates whether the sender of an item requests a read receipt.

IsDeliveryReceiptRequested

Indicates whether the sender of an item requests a delivery receipt.

ConversationIndex

Contains a binary ID that represents the thread to which this message belongs.

ConversationTopic

Represents the conversation identifier.

From

Represents the addressee from whom the message was sent.

InternetMessageId

Represents the Internet message identifier of an item.

IsRead

Indicates whether a message has been read.

IsResponseRequested

Indicates whether a response to an e-mail message is requested.

References

Represents the Usenet header that is used to correlate replies with their original messages.

ReplyTo

Identifies a set of addresses to which replies should be sent.

EffectiveRights

Contains the client's rights based on the permission settings for the item or folder. This element is read-only. This element was introduced in Microsoft Exchange Server 2007 Service Pack 1 (SP1).

ReceivedBy

Identifies the delegate in a delegate access scenario. This element was introduced in Exchange 2007 SP1.

ReceivedRepresenting

Identifies the principal in a delegate access scenario. This element was introduced in Exchange 2007 SP1.

Parent Elements

Element Description

AdjacentMeetings

Describes all calendar items that are adjacent to a meeting time.

AppendToItemField

Identifies data to append to a single property of an item during an UpdateItem Operation.

ConflictingMeetings

Identifies all items that conflict with a meeting time.

Create (ItemSync)

Identifies a single item to create in the local client store.

ItemAttachment

Represents an Exchange item that is attached to another Exchange item.

Items

Contains an array of items.

Items (CreateItem)

Contains an array of items to create in the folder that is identified by the ParentFolderId (Create) element.

SetItemField

Represents an update to a single property of an item in an UpdateItem Operation.

Update (ItemSync)

Identifies a single item to update in the local client store.

Remarks

Another Message element, Message (Availability), is used by the Availability operations to return Out of Office (OOF) messages.

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.

Starting with Exchange 2007 Service Pack 1 (SP1) with Update Rollup 4 (RU4) applied, Message elements represent e-mail messages and all other items that are not strongly typed by the Exchange Web Services (EWS) schema. This behavior is applied when the Exchange2007_SP1 version header is specified. Items such as IPM.Sharing and IPM.InfoPath are returned as Message elements. Exchange 2007 SP1 with RU4 applied and later versions will not return the base Item element in responses. This change may break applications that parse the XML and expect the Item element instead of the Message element.

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

Other Resources

Exchange Web Services XML Elements