Class EmailMessage

Represents an e-mail message (IPM.Note) item, extending Message with e-mail-specific properties defined in [MS-OXOMSG].

Inheritance

object

Message

EmailMessage

PstEmailMessage

Inherited Members

Message.Create(MapiMessage)

Message.SetDefaultValues()

Message.AlternateRecipientAllowed

Message.AutoForwarded

Message.Body

Message.BodyFormat

Message.BodyRtf

Message.Categories

Message.Class

Message.Codepage

Message.Companies

Message.CreationTime

Message.CultureInfo

Message.Encoding

Message.EntryID

Message.Flags

Message.HtmlBody

Message.Importance

Message.InternetCodepage

Message.LastModificationTime

Message.LocaleId

Message.MessageClass

Message.Mileage

Message.NoAging

Message.IsConflict

Message.MarkForDownload

Message.IsRemoteDeletionMarked

Message.Priority

Message.Private

Message.Reminder

Message.RetentionExpirationDate

Message.SetSender(string)

Message.SetSender(string, string)

Message.SetSentRepresenting(string, string)

Message.Size

Message.Subject

Message.Headers

Message.UnRead

Message.SideEffects

Message.Save()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

Namespace: DRIT.Mail.Mapi.API

Assembly: DRIT.Mail.dll

Syntax

public class EmailMessage : Message

Constructors

EmailMessage(MapiEmailMessage)

Initialises a new instance of EmailMessage backed by the given MAPI email message node.

Declaration

public EmailMessage(MapiEmailMessage mapiEmailMessage)

Parameters

Type	Name	Description
MapiEmailMessage	mapiEmailMessage	The underlying MAPI email message property accessor.

Properties

Bcc

Gets a list of Bcc recipient display names, separated by semicolons, if an e-mail message has Bcc recipients. Otherwise, this property contains an empty string, as specified in [MS-OXCMSG] section 3.2.5.2.

Declaration

public string Bcc { get; }

Property Value

Type	Description
string

Remarks

2.2.1.7 PidTagDisplayBcc Property

Cc

Gets a list of Cc recipient display names, separated by semicolons, if an e-mail message has Cc recipients. Otherwise, this property contains an empty string, as specified in [MS-OXCMSG] section 3.2.5.2.

Declaration

public string Cc { get; }

Property Value

Type	Description
string

Remarks

2.2.1.8 PidTagDisplayCc Property

ConversationId

Gets a computed value, derived from other conversation-related properties, that identifies a message as belonging to a specific conversation. This property is computed by the application, server or client.

Declaration

public string ConversationId { get; }

Property Value

Type	Description
string

Remarks

2.2.1.2 PidTagConversationId Property

ConversationTopic

Gets or sets an unchanging copy of the original subject. The property is set to the same value as the PidTagNormalizedSubject property ([MS-OXCMSG] section 2.2.1.10) on an E-mail object when it is submitted.

Declaration

public string ConversationTopic { get; }

Property Value

Type	Description
string

Remarks

This is basically the subject from which Fwd:, Re, etc. has been removed

DeferredDeliveryTime

Gets or sets the date and time, in UTC, at which the sender prefers the message to be delivered.

Declaration

public DateTime? DeferredDeliveryTime { get; set; }

Property Value

Type	Description
DateTime?

Remarks

Reference 2.2.1.6 PidTagDeferredDeliveryTime Property

DeleteAfterSubmit

Gets or sets whether the original message MUST be deleted after the message is sent.

Declaration

public bool? DeleteAfterSubmit { get; set; }

Property Value

Type	Description
bool?

Remarks

If the property is not present, the server uses the value 0x00.

Reference: MS-OXOMSG 2.2.3.8 PidTagDeleteAfterSubmit Property

ExpiryTime

Gets or sets a value which can be present when a client requests to receive an expiry event if the message arrives late.

Declaration

public DateTime? ExpiryTime { get; set; }

Property Value

Type	Description
DateTime?

Remarks

If the ExpiryNumber property and the ExpiryUnits property are both present, the value of this property is recomputed by the following formula; the original value is ignored. PidTagExpiryTime = PidTagClientSubmitTime + PidTagExpiryNumber * TimeOf(PidTagExpiryUnits)

Reference: MS-OXOMSG 2.2.3.7 PidTagExpiryTime Property

HasForwarded

Gets a value indicating whether this message has been forwarded.

Declaration

public bool HasForwarded { get; }

Property Value

Type	Description
bool

Remarks

Derived from the PidTagLastVerbExecuted property: returns true when bit 0x8 is set.

HasReplied

Gets a value indicating whether this object has replied.

Declaration

public bool HasReplied { get; }

Property Value

Type	Description
bool

MapiEmailMessage

Gets or sets the mapi email message value.

Declaration

public MapiEmailMessage MapiEmailMessage { get; }

Property Value

Type	Description
MapiEmailMessage

OriginalSender

Gets or sets the original sender value.

Declaration

public IRecipient OriginalSender { get; }

Property Value

Type	Description
IRecipient

OriginalSentRepresenting

Gets or sets the original sent representing value.

Declaration

public IRecipient OriginalSentRepresenting { get; }

Property Value

Type	Description
IRecipient

OriginatorDeliveryReportRequested

Gets or sets a value that indicates whether an e-mail sender requests an e-mail delivery receipt from an e-mail client or server.

Declaration

public bool? OriginatorDeliveryReportRequested { get; set; }

Property Value

Type	Description
bool?

Remarks

Reference: MS-OXOMSG 2.2.1.20 PidTagOriginatorDeliveryReportRequested Property

ReadReceiptRequested

Gets or sets whether the e-mail sender requests a read receipt from all recipients when this e-mail message is read or opened.

Declaration

public bool? ReadReceiptRequested { get; set; }

Property Value

Type	Description
bool?

Remarks

Reference: MS-OXOMSG 2.2.1.29 PidTagReadReceiptRequested Property

ReceivedBy

Receives messages from the specified source.

Declaration

public IRecipient ReceivedBy { get; }

Property Value

Type	Description
IRecipient

ReceivedOnBehalfOfEntryID

Gets an address book EntryID that contains the e-mail message receiver of the E-mail object.

Declaration

public AddressBookEntryId ReceivedOnBehalfOfEntryID { get; }

Property Value

Type	Description
AddressBookEntryId

Remarks

Reference: MS-OXOMSG 2.2.1.38 PidTagReceivedByEntryId Property

ReceivedOnBehalfOfName

Gets the display name for the end user represented by the receiving mailbox owner, as specified by the DisplayName field of the RecipientRow structure.

Declaration

public string ReceivedOnBehalfOfName { get; }

Property Value

Type	Description
string

Remarks

Reference: MS-OXOMSG 2.2.1.26 PidTagReceivedRepresentingName Property

ReceivedRepresenting

Receives messages from the specified source.

Declaration

public IRecipient ReceivedRepresenting { get; }

Property Value

Type	Description
IRecipient

ReceivedTime

Gets or sets a value which is set by the server to the current time (in UTC) when it receives a message.

Declaration

public virtual DateTime? ReceivedTime { get; }

Property Value

Type	Description
DateTime?

Remarks

Reference: MS-OXOMSG 2.2.3.9 PidTagMessageDeliveryTime Property

RecipientReassignmentProhibited

Gets whether adding additional or different recipients (1), when forwarding the message, is prohibited for the e-mail message.

Declaration

public bool? RecipientReassignmentProhibited { get; set; }

Property Value

Type	Description
bool?

Remarks

Reference: MS-OXOMSG 2.2.1.42 PidTagRecipientReassignmentProhibited Property

ReplyRecipientNames

Gets or sets a list of display names for recipients that are to get a reply.

Declaration

public string ReplyRecipientNames { get; }

Property Value

Type	Description
string

Remarks

If this property is absent, a reply is sent only to the user identified by the PidTagSenderName property (section 2.2.1.51). If present, the property is set to one string containing the address book entry's recipient (2) display names separated by semicolons. Reference: MS-OXOMSG 2.2.1.44 PidTagReplyRecipientNames Property

Sender

Gets or sets the sender value.

Declaration

public IRecipient Sender { get; }

Property Value

Type	Description
IRecipient

Sensitivity

Gets or sets the sender's assessment of the sensitivity of the Message object.

Declaration

public override Sensitivity? Sensitivity { get; set; }

Property Value

Type	Description
Sensitivity?

Overrides

Message.Sensitivity

Remarks

Reference: MS-OXCMSG 2.2.1.13 PidTagSensitivity Property

SentOn

Gets or sets a value which is set by the server to the current time (in UTC) when the e-mail message is submitted.

Declaration

public virtual DateTime? SentOn { get; }

Property Value

Type	Description
DateTime?

Remarks

Reference: MS-OXOMSG 2.2.3.11 PidTagClientSubmitTime Property

SentRepresenting

Gets or sets the sent representing value.

Declaration

public IRecipient SentRepresenting { get; }

Property Value

Type	Description
IRecipient

To

Gets a list of the primary recipient display names, separated by semicolons, if an e-mail message has primary recipients. Otherwise, this property contains an empty string.

Declaration

public string To { get; }

Property Value

Type	Description
string

Remarks

2.2.1.9 PidTagDisplayTo Property

VotingResponse

Gets or sets the voting response value.

Declaration

public string VotingResponse { get; }

Property Value

Type	Description
string

Methods

SetReceivedBy(string, string)

Sets the received by.

Declaration

public void SetReceivedBy(string name, string emailAddress)

Parameters

Type	Name	Description
string	name	Specifies the name value.
string	emailAddress	The email address used by the operation.

SetReceivedRepresenting(string, string)

Sets the received representing.

Declaration

public void SetReceivedRepresenting(string name, string emailAddress)

Parameters

Type	Name	Description
string	name	Specifies the name value.
string	emailAddress	The email address used by the operation.