EmailMessage Class

Definition

Represents an e-mail message.

public ref class EmailMessage : Microsoft::Exchange::WebServices::Data::Item
public class EmailMessage : Microsoft.Exchange.WebServices.Data.Item
Public Class EmailMessage
Inherits Item
Inheritance
EmailMessage
Derived

Remarks

Properties that are available on e-mail messages are defined in the EmailMessageSchema class.

Constructors

EmailMessage(ExchangeService)

Initializes a local instance of the EmailMessage class with an Exchange service object.

Properties

AllowedResponseActions

Gets a value that indicates which response actions are allowed on this item. Examples of response actions are Reply and Forward.

(Inherited from Item)
ApprovalRequestData

Gets approval request details on an approval request message.

ArchiveTag

Gets or sets the archive tag. The ArchiveTag property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Attachments

Gets a list of the attachments to this item.

(Inherited from Item)
BccRecipients

Gets the list of Bcc recipients for the e-mail message.

Body

Gets or sets the body of this item.

(Inherited from Item)
Categories

Gets or sets the list of categories that are associated with this item.

(Inherited from Item)
CcRecipients

Gets the list of Cc recipients for the e-mail message.

ConversationId

Gets the ID of the conversation that this item is part of.

(Inherited from Item)
ConversationIndex

Gets the conversation index of the e-mail message.

ConversationTopic

Gets the conversation topic of the e-mail message.

Culture

Gets or sets the culture that is associated with this item.

(Inherited from Item)
DateTimeCreated

Gets the date and time at which this item was created.

(Inherited from Item)
DateTimeReceived

Gets the time when this item was received.

(Inherited from Item)
DateTimeSent

Gets the date and time at which this item was sent.

(Inherited from Item)
DisplayCc

Gets a text string that lists the Cc recipients of this item.

(Inherited from Item)
DisplayTo

Gets a text string that lists the To recipients of this item.

(Inherited from Item)
EffectiveRights

Gets a value that indicates the effective rights that the current authenticated user has on this item.

(Inherited from Item)
EntityExtractionResult

Gets the entity extraction information on the item. The EntityExtractionResult property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
ExtendedProperties

Gets a list of extended properties that are defined on this item.

(Inherited from Item)
Flag

Gets or sets a flag value that indicates the status, start date, due date, or completion date for an item. The Flag property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
From

Gets or sets who the e-mail came from.

HasAttachments

Gets a value that indicates whether the item has attachments.

(Inherited from Item)
IconIndex

Gets the icon index. The IconIndex property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Id

Gets the ID of this item.

(Inherited from Item)
Importance

Gets or sets the importance of this item.

(Inherited from Item)
InReplyTo

Gets or sets the In-Reply-To reference of this item.

(Inherited from Item)
InstanceKey

Gets the item instance key. The InstanceKey property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
InternetMessageHeaders

Gets a list of Internet headers for this item. To get the entire collection of Internet message headers, use the PR_TRANSPORT_MESSAGE_HEADERS property.

(Inherited from Item)
InternetMessageId

Gets the Internet message identifier of the e-mail message.

IsAssociated

Gets or sets a value that indicates whether this is an associated message.

IsAttachment

Gets a value that indicates whether the item is an attachment.

(Inherited from Item)
IsDeliveryReceiptRequested

Gets or sets a value that indicates whether a delivery receipt is requested for the e-mail message.

IsDirty

Gets a value that indicates whether the object has been modified.

(Inherited from ServiceObject)
IsDraft

Gets a value that indicates whether the item is a draft. An item is a draft when it has not yet been sent.

(Inherited from Item)
IsFromMe

Gets a value that indicates whether the item has been sent by the current authenticated user.

(Inherited from Item)
IsNew

Gets a value that indicates whether this object is a real store item or a local object that has yet to be saved.

(Inherited from Item)
IsRead

Gets or sets a value that indicates whether the e-mail message has been read.

IsReadReceiptRequested

Gets or sets a value that indicates whether a read receipt is requested for the e-mail message.

IsReminderSet

Gets or sets a value that indicates whether a reminder is set for this item.

(Inherited from Item)
IsResend

Gets a value that indicates whether the item is a resend of another item.

(Inherited from Item)
IsResponseRequested

Gets or sets a value that indicates whether a response is requested for the e-mail message.

IsSubmitted

Gets a value that indicates whether the message has been submitted to be sent.

(Inherited from Item)
IsUnmodified

Gets a value that indicates whether the item has been modified since it was created.

(Inherited from Item)
Item[PropertyDefinitionBase]

Gets the value of the specified property in this instance.

(Inherited from ServiceObject)
ItemClass

Gets or sets the custom class name of this item.

(Inherited from Item)
LastModifiedName

Gets the name of the user who last modified this item.

(Inherited from Item)
LastModifiedTime

Gets the date and time that this item was last modified.

(Inherited from Item)
MimeContent

Gets the MIME content of this item.

(Inherited from Item)
NormalizedBody

Gets the message body of an item that has been converted to a normalized value. The NormalizedBody property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
ParentFolderId

Gets the ID of the parent folder of this item.

(Inherited from Item)
PolicyTag

Gets or sets the retention policy value. The PolicyTag property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Preview

Gets the item preview. The Preview property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
ReceivedBy

Gets the delegate who received the e-mail message.

ReceivedRepresenting

Gets the principal of the e-mail message.

References

Gets or sets the references of the e-mail message.

ReminderDueBy

Gets or sets the date and time when the reminder is due for this item.

(Inherited from Item)
ReminderMinutesBeforeStart

Gets or sets the number of minutes before the start of this item that the reminder should be triggered.

(Inherited from Item)
ReplyTo

Gets a list of e-mail addresses to which replies should be addressed.

RetentionDate

Gets the date until which an item must be preserved. The RetentionDate property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Schema

Gets the schema that is associated with this type of object.

(Inherited from ServiceObject)
Sender

Gets or sets the sender of the e-mail message.

Sensitivity

Gets the sensitivity of this item.

(Inherited from Item)
Service

Gets the Exchange service for this object.

(Inherited from ServiceObject)
Size

Gets the size of this item.

(Inherited from Item)
StoreEntryId

Gets the entry ID of the store that hosts the item. The StoreEntryId property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
Subject

Gets or sets the subject of this item.

(Inherited from Item)
TextBody

Gets the text body of the item. The TextBody property is applicable for clients that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

(Inherited from Item)
ToRecipients

Gets the list of To recipients for the e-mail message.

UniqueBody

Gets the body part that is unique to the conversation that this item is part of.

(Inherited from Item)
VotingInformation

Gets voting details on a message that has voting buttons, a voting response, or an approval request message.

WebClientEditFormQueryString

Gets the query string that can be appended to the Outlook Web App URL to open this item in a web browser.

(Inherited from Item)
WebClientReadFormQueryString

Gets the query string that should be appended to the Exchange web client URL to open this item by using the appropriate read form in a web browser.

(Inherited from Item)

Methods

Bind(ExchangeService, ItemId)

Binds to an existing e-mail message and loads its first class properties.

Bind(ExchangeService, ItemId, PropertySet)

Binds to an existing e-mail message and loads the specified set of properties.

Copy(FolderId)

Creates a copy of this item in the specified folder. Calling this method results in a call to Exchange Web Services (EWS).

(Inherited from Item)
Copy(WellKnownFolderName)

Creates a copy of this item in the specified folder. Calling this method results in a call to Exchange Web Services (EWS).

(Inherited from Item)
CreateForward()

Creates a forward response to the message.

CreateReply(Boolean)

Creates a reply response to the message.

Delete(DeleteMode)

Deletes the item. Calling this method results in a call to Exchange Web Services (EWS).

(Inherited from Item)
Delete(DeleteMode, Boolean)

Deletes the item. Calling this method results in a call to EWS.

(Inherited from Item)
Forward(MessageBody, EmailAddress[])

Forwards the message.

Forward(MessageBody, IEnumerable<EmailAddress>)

Forwards the message.

GetLoadedPropertyDefinitions()

Provides the collection of loaded property definitions.

(Inherited from ServiceObject)
Load()

Loads the first-class properties.

(Inherited from ServiceObject)
Load(PropertySet)

Loads the specified set of properties.

(Inherited from ServiceObject)
Move(FolderId)

Moves this item to the specified folder. Calling this method results in a call to Exchange Web Services (EWS).

(Inherited from Item)
Move(WellKnownFolderName)

Moves this item to the specified folder. Calling this method results in a call to Exchange Web Services (EWS).

(Inherited from Item)
RemoveExtendedProperty(ExtendedPropertyDefinition)

Removes an extended property.

(Inherited from Item)
Reply(MessageBody, Boolean)

Replies to the message.

Save()

Saves this item in the default folder based on the item's type. Calling this method results in at least one call to Exchange Web Services (EWS). Multiple calls to EWS might be made if attachments have been added.

(Inherited from Item)
Save(FolderId)

Saves this item in a specific folder. Calling this method results in at least one call to Exchange Web Services (EWS). Multiple calls to EWS might be made if attachments have been added.

(Inherited from Item)
Save(WellKnownFolderName)

Saves this item in a specific folder. Calling this method results in at least one call to Exchange Web Services (EWS). Multiple calls to EWS might be made if attachments have been added.

(Inherited from Item)
Send()

Sends this e-mail message.

SendAndSaveCopy()

Sends this e-mail message and saves a copy of it in the Sent Items folder.

SendAndSaveCopy(FolderId)

Sends this e-mail message and saves a copy of it in the specified folder.

SendAndSaveCopy(WellKnownFolderName)

Sends this e-mail message and saves a copy of it in the specified folder.

SetExtendedProperty(ExtendedPropertyDefinition, Object)

Sets the specified extended property to the specified value.

(Inherited from Item)
SuppressReadReceipt()

Suppresses the read receipt on the message.

TryGetProperty(PropertyDefinitionBase, Object)

Tries to get the value of a specified property.

(Inherited from ServiceObject)
TryGetProperty<T>(PropertyDefinitionBase, T)

Tries to get the value of a specified property.

(Inherited from ServiceObject)
Update(ConflictResolutionMode)

Applies the local changes that have been made to this item. Calling this method results in at least one call to Exchange Web Services (EWS). Multiple calls to EWS might be made if attachments have been added or removed.

(Inherited from Item)
Update(ConflictResolutionMode, Boolean)

Applies the local changes that have been made to this item. Calling this method results in at least one call to EWS. Mutliple calls to EWS might be made if attachments have been added or removed.

(Inherited from Item)

Applies to