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
| 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.
- Value
- EmailMessageDownloadState EmailMessageDownloadState EmailMessageDownloadState EmailMessageDownloadState
The download status of an email message.
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.
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.
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.
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.
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.
| 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.
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.
An object that identifies the name and address of the person sending the message.
| 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.
- Value
- IRandomAccessStreamReference IRandomAccessStreamReference IRandomAccessStreamReference IRandomAccessStreamReference
The MIME data associated with an email message.
| 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.
The type of S/MIME encryption/signature for the email message.
| 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.
The kind of message body; plain text or HTML.
The selected body stream.
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.
Indicates which body stream, plain text or HTML.
- stream
- IRandomAccessStreamReference IRandomAccessStreamReference IRandomAccessStreamReference IRandomAccessStreamReference
The message for the specified body stream.