EmailMessage EmailMessage EmailMessage EmailMessage Class

Definition

Represents an email message.

public : sealed class EmailMessage : IEmailMessage, IEmailMessage2, IEmailMessage3, IEmailMessage4public sealed class EmailMessage : IEmailMessage, IEmailMessage2, IEmailMessage3, IEmailMessage4Public NotInheritable Class EmailMessage Implements IEmailMessage, IEmailMessage2, IEmailMessage3, IEmailMessage4// You can use this class in JavaScript.
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Constructors

EmailMessage() EmailMessage() EmailMessage() EmailMessage()

Creates an instance of the EmailMessage class.

public : EmailMessage()public EmailMessage()Public Sub New()// You can use this method in JavaScript.

Properties

AllowInternetImages AllowInternetImages AllowInternetImages AllowInternetImages

Gets or sets a Boolean value indicating whether images may be embedded in the html encoded email message.

public : PlatForm::Boolean AllowInternetImages { get; set; }public bool AllowInternetImages { get; set; }Public ReadWrite Property AllowInternetImages As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

A Boolean value indicating whether images may be embedded in the html encoded email message.

Attachments Attachments Attachments Attachments

Gets the attachments of the email message.

public : IVector<EmailAttachment> Attachments { get; }public IList<EmailAttachment> Attachments { get; }Public ReadOnly Property Attachments As IList<EmailAttachment>// You can use this property in JavaScript.
Value
IVector<EmailAttachment> IList<EmailAttachment> IList<EmailAttachment> IList<EmailAttachment>

The attachments to the email message.

Bcc Bcc Bcc Bcc

Gets the recipients BCC'd to the email message.

public : IVector<EmailRecipient> Bcc { get; }public IList<EmailRecipient> Bcc { get; }Public ReadOnly Property Bcc As IList<EmailRecipient>// You can use this property in JavaScript.
Value
IVector<EmailRecipient> IList<EmailRecipient> IList<EmailRecipient> IList<EmailRecipient>

The recipients BCC'd to the email message.

Body Body Body Body

Gets or sets the body of the email message.

public : PlatForm::String Body { get; set; }public string Body { get; set; }Public ReadWrite Property Body As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The body of the email message.

CC CC CC CC

Gets the recipients CC'd to the email message.

public : IVector<EmailRecipient> CC { get; }public IList<EmailRecipient> CC { get; }Public ReadOnly Property CC As IList<EmailRecipient>// You can use this property in JavaScript.
Value
IVector<EmailRecipient> IList<EmailRecipient> IList<EmailRecipient> IList<EmailRecipient>

The recipients CC'd to the email message.

ChangeNumber ChangeNumber ChangeNumber ChangeNumber

Gets the current change number which is incremented for each change made to an email message.

public : ulong ChangeNumber { get; }public ulong ChangeNumber { get; }Public ReadOnly Property ChangeNumber As ulong// You can use this property in JavaScript.
Value
ulong ulong ulong ulong

The current change number .

ConversationId ConversationId ConversationId ConversationId

Gets the identifier for a conversation.

public : PlatForm::String ConversationId { get; }public string ConversationId { get; }Public ReadOnly Property ConversationId As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The identifier for a conversation.

DownloadState DownloadState DownloadState DownloadState

Gets or sets the download status of an email message.

public : EmailMessageDownloadState DownloadState { get; set; }public EmailMessageDownloadState DownloadState { get; set; }Public ReadWrite Property DownloadState As EmailMessageDownloadState// You can use this property in JavaScript.

EstimatedDownloadSizeInBytes EstimatedDownloadSizeInBytes EstimatedDownloadSizeInBytes EstimatedDownloadSizeInBytes

Gets or sets the estimated size, in bytes, of an email message download.

public : unsigned int EstimatedDownloadSizeInBytes { get; set; }public uint EstimatedDownloadSizeInBytes { get; set; }Public ReadWrite Property EstimatedDownloadSizeInBytes As uint// You can use this property in JavaScript.
Value
unsigned int uint uint uint

The estimated size, in bytes, of an email message download.

FlagState FlagState FlagState FlagState

Represents the flag status of an email message.

public : EmailFlagState FlagState { get; set; }public EmailFlagState FlagState { get; set; }Public ReadWrite Property FlagState As EmailFlagState// You can use this property in JavaScript.
Value
EmailFlagState EmailFlagState EmailFlagState EmailFlagState

The flag status of an email message.

FolderId FolderId FolderId FolderId

Gets the identifier of a folder in the inbox.

public : PlatForm::String FolderId { get; }public string FolderId { get; }Public ReadOnly Property FolderId As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The identifier of a folder in the inbox.

HasPartialBodies HasPartialBodies HasPartialBodies HasPartialBodies

Gets a Boolean value indicating whether this email message contains partial bodies.

public : PlatForm::Boolean HasPartialBodies { get; }public bool HasPartialBodies { get; }Public ReadOnly Property HasPartialBodies As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

The Boolean value indicating whether this email message contains partial bodies.

Id Id Id Id

Gets the identifier of an email message.

public : PlatForm::String Id { get; }public string Id { get; }Public ReadOnly Property Id As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The identifier of an email message.

Importance Importance Importance Importance

Gets the importance of an email message.

public : EmailImportance Importance { get; set; }public EmailImportance Importance { get; set; }Public ReadWrite Property Importance As EmailImportance// You can use this property in JavaScript.
Value
EmailImportance EmailImportance EmailImportance EmailImportance

The importance of an email message.

InResponseToMessageId InResponseToMessageId InResponseToMessageId InResponseToMessageId

Gets the identifier for the email message to which this message is a response.

public : PlatForm::String InResponseToMessageId { get; }public string InResponseToMessageId { get; }Public ReadOnly Property InResponseToMessageId As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The identifier for the email message to which this message is a response.

IrmInfo IrmInfo IrmInfo IrmInfo

Gets or sets the Information Rights Management (IRM) information for this email message.

public : EmailIrmInfo IrmInfo { get; set; }public EmailIrmInfo IrmInfo { get; set; }Public ReadWrite Property IrmInfo As EmailIrmInfo// You can use this property in JavaScript.
Value
EmailIrmInfo EmailIrmInfo EmailIrmInfo EmailIrmInfo

The Information Rights Management (IRM) information for this email message.

IsDraftMessage IsDraftMessage IsDraftMessage IsDraftMessage

Gets a Boolean value indicating whether this message is a draft.

public : PlatForm::Boolean IsDraftMessage { get; }public bool IsDraftMessage { get; }Public ReadOnly Property IsDraftMessage As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

A Boolean value indicating whether this message is a draft.

IsRead IsRead IsRead IsRead

Gets a Boolean value indicating whether the email message has been read.

public : PlatForm::Boolean IsRead { get; set; }public bool IsRead { get; set; }Public ReadWrite Property IsRead As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

A Boolean value indicating whether the email message has been read.

IsSeen IsSeen IsSeen IsSeen

Gets a Boolean value indicating whether the email message has been seen.

public : PlatForm::Boolean IsSeen { get; set; }public bool IsSeen { get; set; }Public ReadWrite Property IsSeen As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

A Boolean value indicating whether the email message has been seen.

IsServerSearchMessage IsServerSearchMessage IsServerSearchMessage IsServerSearchMessage

Gets a Boolean value indicating whether the email message is a temporary server search message.

public : PlatForm::Boolean IsServerSearchMessage { get; }public bool IsServerSearchMessage { get; }Public ReadOnly Property IsServerSearchMessage As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

The Boolean value indicating whether the email message is a temporary server search message.

IsSmartSendable IsSmartSendable IsSmartSendable IsSmartSendable

Gets a Boolean value indicating whether the response email message is allowed to attempt a smart send, only sending that portion of the email message that has changed.

public : PlatForm::Boolean IsSmartSendable { get; }public bool IsSmartSendable { get; }Public ReadOnly Property IsSmartSendable As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

A Boolean value indicating whether the response email message is allowed to attempt a smart send.

LastResponseKind LastResponseKind LastResponseKind LastResponseKind

Gets the last kind of response sent in reference to this email message.

public : EmailMessageResponseKind LastResponseKind { get; set; }public EmailMessageResponseKind LastResponseKind { get; set; }Public ReadWrite Property LastResponseKind As EmailMessageResponseKind// You can use this property in JavaScript.
Value
EmailMessageResponseKind EmailMessageResponseKind EmailMessageResponseKind EmailMessageResponseKind

The last kind of response sent in reference to this email message.

MailboxId MailboxId MailboxId MailboxId

Gets the identifier of the mailbox.

public : PlatForm::String MailboxId { get; }public string MailboxId { get; }Public ReadOnly Property MailboxId As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The identifier of the mailbox.

MeetingInfo MeetingInfo MeetingInfo MeetingInfo

Gets the information associated with this meeting.

public : EmailMeetingInfo MeetingInfo { get; set; }public EmailMeetingInfo MeetingInfo { get; set; }Public ReadWrite Property MeetingInfo As EmailMeetingInfo// You can use this property in JavaScript.
Value
EmailMeetingInfo EmailMeetingInfo EmailMeetingInfo EmailMeetingInfo

The information associated with this meeting.

MessageClass MessageClass MessageClass MessageClass

Gets or sets a string that indicates the class of the message.

public : PlatForm::String MessageClass { get; set; }public string MessageClass { get; set; }Public ReadWrite Property MessageClass As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The string that indicates the class of the message.

NormalizedSubject NormalizedSubject NormalizedSubject NormalizedSubject

Gets the subject line of an email message stripped of additional prefixes such as fwd: and re:

public : PlatForm::String NormalizedSubject { get; }public string NormalizedSubject { get; }Public ReadOnly Property NormalizedSubject As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The subject line of an email message stripped of additional prefixes such as fwd: and re:

OriginalCodePage OriginalCodePage OriginalCodePage OriginalCodePage

Gets or sets the integer that identifies the original flavor of the character set used so that when the email message is condensed from wide character format (16-bit) to ASCII or other 8-bit encoding, in cases of later encoding questions, this integer can be used to recreate the original character set.

public : int OriginalCodePage { get; set; }public int OriginalCodePage { get; set; }Public ReadWrite Property OriginalCodePage As int// You can use this property in JavaScript.
Value
int int int int

The integer that identifies the original flavor of the character set used

Preview Preview Preview Preview

Gets or sets the short preview string that represents the longer email message in the list view of emails.

public : PlatForm::String Preview { get; set; }public string Preview { get; set; }Public ReadWrite Property Preview As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The short preview string that represents the longer email message in the list view of emails.

RemoteId RemoteId RemoteId RemoteId

Gets or sets the identifier that can be used by a service provider to access the email message on the client machine.

public : PlatForm::String RemoteId { get; set; }public string RemoteId { get; set; }Public ReadWrite Property RemoteId As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The identifier that can be used by a service provider to access the email message on the client machine.

ReplyTo ReplyTo ReplyTo ReplyTo

Gets the recipients that are configured to receive a reply to the email message.

public : IVector<EmailRecipient> ReplyTo { get; }public IList<EmailRecipient> ReplyTo { get; }Public ReadOnly Property ReplyTo As IList<EmailRecipient>// You can use this property in JavaScript.
Value
IVector<EmailRecipient> IList<EmailRecipient> IList<EmailRecipient> IList<EmailRecipient>

The recipients that are configured to receive a reply to the email message.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

Sender Sender Sender Sender

Gets or sets the mailbox from which the email message was sent.

public : EmailRecipient Sender { get; set; }public EmailRecipient Sender { get; set; }Public ReadWrite Property Sender As EmailRecipient// You can use this property in JavaScript.
Value
EmailRecipient EmailRecipient EmailRecipient EmailRecipient

The mailbox from which the email message was sent.

SentRepresenting SentRepresenting SentRepresenting SentRepresenting

Gets or sets an object that identifies the name and address of the person sending the message.

public : EmailRecipient SentRepresenting { get; set; }public EmailRecipient SentRepresenting { get; set; }Public ReadWrite Property SentRepresenting As EmailRecipient// You can use this property in JavaScript.
Value
EmailRecipient EmailRecipient EmailRecipient EmailRecipient

An object that identifies the name and address of the person sending the message.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

SentTime SentTime SentTime SentTime

Gets or sets the time an email was sent.

public : IReference<DateTime> SentTime { get; set; }public Nullable<DateTimeOffset> SentTime { get; set; }Public ReadWrite Property SentTime As Nullable<DateTimeOffset>// You can use this property in JavaScript.
Value
IReference<DateTime> Nullable<DateTimeOffset> Nullable<DateTimeOffset> Nullable<DateTimeOffset>

The time an email was sent.

SmimeData SmimeData SmimeData SmimeData

Gets or sets the S/MIME data associated with an email message. For more information, see the Certificate class.

public : IRandomAccessStreamReference SmimeData { get; set; }public IRandomAccessStreamReference SmimeData { get; set; }Public ReadWrite Property SmimeData As IRandomAccessStreamReference// You can use this property in JavaScript.
Additional features and requirements
Device family
Windows 10 (introduced v10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v2)

Remarks

For more information about S/MIME encryption and certificates, see [Secure/Multipurpose Internet Mail Extensions (S/MIME) Version 3.2

                     Message Specification.](https://tools.ietf.org/html/rfc5751 )

SmimeKind SmimeKind SmimeKind SmimeKind

Gets or sets the type of S/MIME encryption/signature for the email message.

public : EmailMessageSmimeKind SmimeKind { get; set; }public EmailMessageSmimeKind SmimeKind { get; set; }Public ReadWrite Property SmimeKind As EmailMessageSmimeKind// You can use this property in JavaScript.
Value
EmailMessageSmimeKind EmailMessageSmimeKind EmailMessageSmimeKind EmailMessageSmimeKind

The type of S/MIME encryption/signature for the email message.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v2)

Subject Subject Subject Subject

Gets or sets the subject of the email message.

public : PlatForm::String Subject { get; set; }public string Subject { get; set; }Public ReadWrite Property Subject As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The subject of the email.

To To To To

Gets the direct recipients of the email message.

public : IVector<EmailRecipient> To { get; }public IList<EmailRecipient> To { get; }Public ReadOnly Property To As IList<EmailRecipient>// You can use this property in JavaScript.
Value
IVector<EmailRecipient> IList<EmailRecipient> IList<EmailRecipient> IList<EmailRecipient>

The recipients of the email message.

Methods

GetBodyStream(EmailMessageBodyKind) GetBodyStream(EmailMessageBodyKind) GetBodyStream(EmailMessageBodyKind) GetBodyStream(EmailMessageBodyKind)

Gets the requested email stream such as plain text or HTML.

public : IRandomAccessStreamReference GetBodyStream(EmailMessageBodyKind type)public IRandomAccessStreamReference GetBodyStream(EmailMessageBodyKind type)Public Function GetBodyStream(type As EmailMessageBodyKind) As IRandomAccessStreamReference// You can use this method in JavaScript.
Parameters
type
EmailMessageBodyKind EmailMessageBodyKind EmailMessageBodyKind EmailMessageBodyKind

The kind of message body; plain text or HTML.

Returns

SetBodyStream(EmailMessageBodyKind, IRandomAccessStreamReference) SetBodyStream(EmailMessageBodyKind, IRandomAccessStreamReference) SetBodyStream(EmailMessageBodyKind, IRandomAccessStreamReference) SetBodyStream(EmailMessageBodyKind, IRandomAccessStreamReference)

Sets the value of the specified body stream in an email message.

public : void SetBodyStream(EmailMessageBodyKind type, IRandomAccessStreamReference stream)public void SetBodyStream(EmailMessageBodyKind type, IRandomAccessStreamReference stream)Public Function SetBodyStream(type As EmailMessageBodyKind, stream As IRandomAccessStreamReference) As void// You can use this method in JavaScript.
Parameters
type
EmailMessageBodyKind EmailMessageBodyKind EmailMessageBodyKind EmailMessageBodyKind

Indicates which body stream, plain text or HTML.