Share via


MailItem Members

Include Protected Members
Include Inherited Members

Represents a mail message in an Inbox folder.

The MailItem type exposes the following members.

Properties

 

Name

Description

Public property

Actions

Returns an Actions collection that represents all the available actions for the item. Read-only. (Inherited from _MailItem.)

Public property

AlternateRecipientAllowed

Returns True if the mail message can be forwarded. Read/write. (Inherited from _MailItem.)

Public property

Application

Returns an Application object that represents the parent Outlook application for the object. Read-only. (Inherited from _MailItem.)

Public property

Attachments

Returns an Attachments object that represents all the attachments for the specified item. Read-only. (Inherited from _MailItem.)

Public property

AutoForwarded

A Boolean value (bool in C#) that returns True if the item was automatically forwarded. Read/write. (Inherited from _MailItem.)

Public property

AutoResolvedWinner

Returns a Boolean (bool in C#) that determines if the item is a winner of an automatic conflict resolution. Read-only. (Inherited from _MailItem.)

Public property

BCC

Returns a String (string in C#) representing the display list of blind carbon copy (BCC) names for a MailItem. Read/write. (Inherited from _MailItem.)

Public property

BillingInformation

Returns or sets a String (string in C#) representing the billing information associated with the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

Body

Returns or sets a String (string in C#) representing the clear-text body of the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

BodyFormat

Returns or sets an OlBodyFormat constant indicating the format of the body text. Read/write. (Inherited from _MailItem.)

Public property

Categories

Returns or sets a String (string in C#) representing the categories assigned to the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

CC

Returns a String (string in C#) representing the display list of carbon copy (CC) names for a MailItem . Read/write. (Inherited from _MailItem.)

Public property

Class

Returns an OlObjectClass constant indicating the object's class. Read-only. (Inherited from _MailItem.)

Public property

Companies

Returns or sets a String (string in C#) representing the names of the companies associated with the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

Conflicts

Return the Conflicts object that represents the items that are in conflict for any Outlook item object. Read-only. (Inherited from _MailItem.)

Public property

ConversationIndex

Returns a String (string in C#) representing the index of the conversation thread of the Outlook item. Read-only. (Inherited from _MailItem.)

Public property

ConversationTopic

Returns a String (string in C#) representing the topic of the conversation thread of the Outlook item. Read-only. (Inherited from _MailItem.)

Public property

CreationTime

Returns a Date indicating the creation time for the Outlook item. Read-only. (Inherited from _MailItem.)

Public property

DeferredDeliveryTime

Returns or sets a Date indicating the date and time the mail message is to be delivered. Read/write. (Inherited from _MailItem.)

Public property

DeleteAfterSubmit

Returns or sets a Boolean value (bool in C#) that is True if a copy of the mail message is not saved upon being sent, and False if a copy is saved. Read/write. (Inherited from _MailItem.)

Public property

DownloadState

Returns a constant that belongs to the OlDownloadState enumeration indicating the download state of the item. Read-only. (Inherited from _MailItem.)

Public property

EnableSharedAttachments

This object, member, or enumeration is deprecated and is not intended to be used in your code. (Inherited from _MailItem.)

Public property

EntryID

Returns a String (string in C#) representing the unique Entry ID of the object. Read-only. (Inherited from _MailItem.)

Public property

ExpiryTime

Returns or sets a Date indicating the date and time at which the item becomes invalid and can be deleted. Read/write. (Inherited from _MailItem.)

Public property

FlagDueBy

This object, member, or enumeration is deprecated and is not intended to be used in your code. (Inherited from _MailItem.)

Public property

FlagIcon

This object, member, or enumeration is deprecated and is not intended to be used in your code. (Inherited from _MailItem.)

Public property

FlagRequest

Returns or sets a String (string in C#) that indicates the requested action for a mail item. Read/write. (Inherited from _MailItem.)

Public property

FlagStatus

This object, member, or enumeration is deprecated and is not intended to be used in your code. (Inherited from _MailItem.)

Public property

FormDescription

Returns the FormDescription object that represents the form description for the specified Outlook item. Read-only. (Inherited from _MailItem.)

Public property

GetInspector

Returns an Inspector object that represents an inspector initialized to contain the specified item. Read-only. (Inherited from _MailItem.)

Public property

HasCoverSheet

This object, member, or enumeration is deprecated and is not intended to be used in your code. (Inherited from _MailItem.)

Public property

HTMLBody

Returns or sets a String (string in C#) representing the HTML body of the specified item. Read/write. (Inherited from _MailItem.)

Public property

Importance

Returns or sets an OlImportance constant indicating the relative importance level for the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

InternetCodepage

Returns or sets an Integer (int in C#) value that determines the Internet code page used by the item. Read/write. (Inherited from _MailItem.)

Public property

IsConflict

Returns a Boolean (bool in C#) that determines if the item is in conflict. Read-only. (Inherited from _MailItem.)

Public property

IsIPFax

This object, member, or enumeration is deprecated and is not intended to be used in your code. (Inherited from _MailItem.)

Public property

IsMarkedAsTask

Returns a Boolean value (bool in C#) that indicates whether the MailItem is marked as a task. Read-only. (Inherited from _MailItem.)

Public property

ItemProperties

Returns an ItemProperties collection that represents all standard and user-defined properties associated with the Outlook item. Read-only. (Inherited from _MailItem.)

Public property

LastModificationTime

Returns a Date specifying the date and time that the Outlook item was last modified. Read-only. (Inherited from _MailItem.)

Public property

Links

Returns a Links collection that represents the contacts to which the item is linked. Read-only. (Inherited from _MailItem.)

Public property

MAPIOBJECT

This object, member, or enumeration is deprecated and is not intended to be used in your code. (Inherited from _MailItem.)

Public property

MarkForDownload

Returns or sets an OlRemoteStatus constant that determines the status of an item once it is received by a remote user. Read/write. (Inherited from _MailItem.)

Public property

MessageClass

Returns or sets a String (string in C#) representing the message class for the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

Mileage

Returns or sets a String (string in C#) representing the mileage for an item. Read/write. (Inherited from _MailItem.)

Public property

NoAging

Returns or sets a Boolean value (bool in C#) that is True to not age the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

OriginatorDeliveryReportRequested

Returns or sets a Boolean value (bool in C#) that determines whether the originator of the meeting item or mail message will receive a delivery report. Read/write. (Inherited from _MailItem.)

Public property

OutlookInternalVersion

Returns an Integer (int in C#) value representing the build number of the Outlook application for an Outlook item. Read-only. (Inherited from _MailItem.)

Public property

OutlookVersion

Returns a String (string in C#) indicating the major and minor version number of the Outlook application for an Outlook item. Read-only. (Inherited from _MailItem.)

Public property

Parent

Returns the parent Object of the specified object. Read-only. (Inherited from _MailItem.)

Public property

Permission

Sets or returns an OlPermission constant that determines the permissions the recipients will have on the e-mail item. Read/write. (Inherited from _MailItem.)

Public property

PermissionService

Sets or returns an OlPermissionService constant that determines the permission service that will be used when sending a message protected by Information Rights Management (IRM). Read/write. (Inherited from _MailItem.)

Public property

PropertyAccessor

Returns a PropertyAccessor object that supports creating, getting, setting, and deleting properties of the parent MailItem object. Read-only. (Inherited from _MailItem.)

Public property

ReadReceiptRequested

Returns a Boolean (bool in C#) value that indicates True if a read receipt has been requested by the sender. (Inherited from _MailItem.)

Public property

ReceivedByEntryID

Returns a String (string in C#) representing the EntryID for the true recipient as set by the transport provider delivering the mail message. Read-only. (Inherited from _MailItem.)

Public property

ReceivedByName

Returns a String (string in C#) representing the display name of the true recipient for the mail message. Read-only. (Inherited from _MailItem.)

Public property

ReceivedOnBehalfOfEntryID

Returns a String (string in C#) representing the EntryID of the user delegated to represent the recipient for the mail message. Read-only. (Inherited from _MailItem.)

Public property

ReceivedOnBehalfOfName

Returns a String (string in C#) representing the display name of the user delegated to represent the recipient for the mail message. Read-only. (Inherited from _MailItem.)

Public property

ReceivedTime

Returns a Date indicating the date and time at which the item was received. Read-only. (Inherited from _MailItem.)

Public property

RecipientReassignmentProhibited

Returns a Boolean (bool in C#) that indicates True if the recipient cannot forward the mail message. Read/write. (Inherited from _MailItem.)

Public property

Recipients

Returns a Recipients collection that represents all the recipients for the Outlook item. Read-only. (Inherited from _MailItem.)

Public property

ReminderOverrideDefault

Returns or sets a Boolean value (bool in C#) that is True if the reminder overrides the default reminder behavior for the item. Read/write. (Inherited from _MailItem.)

Public property

ReminderPlaySound

Returns or sets a Boolean value (bool in C#) that is True if the reminder should play a sound when it occurs for this item. Read/write. (Inherited from _MailItem.)

Public property

ReminderSet

Returns or sets a Boolean value (bool in C#) that is True if a reminder has been set for this item. Read/write. (Inherited from _MailItem.)

Public property

ReminderSoundFile

Returns or sets a String (string in C#) indicating the path and file name of the sound file to play when the reminder occurs for the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

ReminderTime

Returns or sets a Date indicating the date and time at which the reminder should occur for the specified item. Read/write. (Inherited from _MailItem.)

Public property

RemoteStatus

Returns or sets an OlRemoteStatus constant specifying the remote status of the mail message. Read/write. (Inherited from _MailItem.)

Public property

ReplyRecipientNames

Returns a semicolon-delimited String (string in C#) list of reply recipients for the mail message. Read-only. (Inherited from _MailItem.)

Public property

ReplyRecipients

Returns a Recipients collection that represents all the reply recipient objects for the Outlook item. Read-only. (Inherited from _MailItem.)

Public property

Saved

Returns a Boolean value (bool in C#) that is True if the Outlook item has not been modified since the last save. Read-only. (Inherited from _MailItem.)

Public property

SaveSentMessageFolder

Returns or sets a Folder object that represents the folder in which a copy of the e-mail message will be saved after being sent. Read/write. (Inherited from _MailItem.)

Public property

SenderEmailAddress

Returns a String (string in C#) that represents the e-mail address of the sender of the Outlook item. Read-only. (Inherited from _MailItem.)

Public property

SenderEmailType

Returns a String (string in C#) that represents the type of entry for the e-mail address of the sender of the Outlook item, such as 'SMTP' for Internet address, 'EX' for a Microsoft Exchange server address, etc. Read-only. (Inherited from _MailItem.)

Public property

SenderName

Returns a String (string in C#) indicating the display name of the sender for the Outlook item. Read-only. (Inherited from _MailItem.)

Public property

SendUsingAccount

Returns or sets an Account object that represents the account under which the MailItem is to be sent. Read/write. (Inherited from _MailItem.)

Public property

Sensitivity

Returns or sets a constant in the OlSensitivity enumeration indicating the sensitivity for the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

Sent

Returns a Boolean value (bool in C#) that indicates if a message has been sent. Read-only. (Inherited from _MailItem.)

Public property

SentOn

Returns a Date indicating the date and time on which the Outlook item was sent. Read-only. (Inherited from _MailItem.)

Public property

SentOnBehalfOfName

Returns a String (string in C#) indicating the display name for the intended sender of the mail message. Read/write. (Inherited from _MailItem.)

Public property

Session

Returns the NameSpace object for the current session. Read-only. (Inherited from _MailItem.)

Public property

Size

Returns an Integer (int in C#) value indicating the size (in bytes) of the Outlook item. Read-only. (Inherited from _MailItem.)

Public property

Subject

Returns or sets a String (string in C#) indicating the subject for the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

Submitted

Returns a Boolean value (bool in C#) that is True if the item has been submitted. Read-only. (Inherited from _MailItem.)

Public property

TaskCompletedDate

Returns or sets a DateTime value that represents the completion date of the task for this MailItem. Read/write. (Inherited from _MailItem.)

Public property

TaskDueDate

Returns or sets a DateTime value that represents the due date of the task for this MailItem. Read/write. (Inherited from _MailItem.)

Public property

TaskStartDate

Returns or sets a DateTime value that represents the start date of the task for this MailItem object. Read/write. (Inherited from _MailItem.)

Public property

TaskSubject

Returns or sets a String (string in C#) value that represents the subject of the task for the MailItem object. Read/write. (Inherited from _MailItem.)

Public property

To

Returns or sets a semicolon-delimited String (string in C#) list of display names for the To recipients for the Outlook item. Read/write. (Inherited from _MailItem.)

Public property

ToDoTaskOrdinal

Returns or sets a DateTime value that represents the ordinal value of the task for the MailItem. Read/write. (Inherited from _MailItem.)

Public property

UnRead

Returns or sets a Boolean value (bool in C#) that is True if the Outlook item has not been opened (read). Read/write. (Inherited from _MailItem.)

Public property

UserProperties

Returns the UserProperties collection that represents all the user properties for the Outlook item. Read-only. (Inherited from _MailItem.)

Public property

VotingOptions

Returns or sets a String (string in C#) specifying a delimited string containing the voting options for the mail message. Read/write. (Inherited from _MailItem.)

Public property

VotingResponse

Returns or sets a String (string in C#) specifying the voting response for the mail message. Read/write. (Inherited from _MailItem.)

Top

Methods

 

Name

Description

Public method

add_AttachmentAdd

(Inherited from ItemEvents_10_Event.)

Public method

add_AttachmentRead

(Inherited from ItemEvents_10_Event.)

Public method

add_AttachmentRemove

(Inherited from ItemEvents_10_Event.)

Public method

add_BeforeAttachmentAdd

(Inherited from ItemEvents_10_Event.)

Public method

add_BeforeAttachmentPreview

(Inherited from ItemEvents_10_Event.)

Public method

add_BeforeAttachmentRead

(Inherited from ItemEvents_10_Event.)

Public method

add_BeforeAttachmentSave

(Inherited from ItemEvents_10_Event.)

Public method

add_BeforeAttachmentWriteToTempFile

(Inherited from ItemEvents_10_Event.)

Public method

add_BeforeAutoSave

(Inherited from ItemEvents_10_Event.)

Public method

add_BeforeCheckNames

(Inherited from ItemEvents_10_Event.)

Public method

add_BeforeDelete

(Inherited from ItemEvents_10_Event.)

Public method

add_Close

(Inherited from ItemEvents_10_Event.)

Public method

add_CustomAction

(Inherited from ItemEvents_10_Event.)

Public method

add_CustomPropertyChange

(Inherited from ItemEvents_10_Event.)

Public method

add_Forward

(Inherited from ItemEvents_10_Event.)

Public method

add_Open

(Inherited from ItemEvents_10_Event.)

Public method

add_PropertyChange

(Inherited from ItemEvents_10_Event.)

Public method

add_Read

(Inherited from ItemEvents_10_Event.)

Public method

add_Reply

(Inherited from ItemEvents_10_Event.)

Public method

add_ReplyAll

(Inherited from ItemEvents_10_Event.)

Public method

add_Send

(Inherited from ItemEvents_10_Event.)

Public method

add_Unload

(Inherited from ItemEvents_10_Event.)

Public method

add_Write

(Inherited from ItemEvents_10_Event.)

Public method

AddBusinessCard

Appends contact information based on the Electronic Business Card (EBC) associated with the specified ContactItem object to the MailItem object. (Inherited from _MailItem.)

Public method

ClearConversationIndex

Clears the index of the conversation thread for the mail message. (Inherited from _MailItem.)

Public method

ClearTaskFlag

Clears the MailItem object as a task. (Inherited from _MailItem.)

Public method

Close

Closes and optionally saves changes to the Outlook item. (Inherited from _MailItem.)

Public method

Copy

Creates another instance of an object. (Inherited from _MailItem.)

Public method

Delete

Deletes an object from the collection. (Inherited from _MailItem.)

Public method

Display

Displays a new Inspector object for the item. (Inherited from _MailItem.)

Public method

Forward

Executes the Forward action for an item and returns the resulting copy as a MailItem object. (Inherited from _MailItem.)

Public method

MarkAsTask

Marks a MailItem object as a task and assigns a task interval for the object. (Inherited from _MailItem.)

Public method

Move

Moves a Microsoft Outlook item to a new folder. (Inherited from _MailItem.)

Public method

PrintOut

Prints the Outlook item using all default settings.The PrintOut method is the only Outlook method that can be used for printing. (Inherited from _MailItem.)

Public method

remove_AttachmentAdd

(Inherited from ItemEvents_10_Event.)

Public method

remove_AttachmentRead

(Inherited from ItemEvents_10_Event.)

Public method

remove_AttachmentRemove

(Inherited from ItemEvents_10_Event.)

Public method

remove_BeforeAttachmentAdd

(Inherited from ItemEvents_10_Event.)

Public method

remove_BeforeAttachmentPreview

(Inherited from ItemEvents_10_Event.)

Public method

remove_BeforeAttachmentRead

(Inherited from ItemEvents_10_Event.)

Public method

remove_BeforeAttachmentSave

(Inherited from ItemEvents_10_Event.)

Public method

remove_BeforeAttachmentWriteToTempFile

(Inherited from ItemEvents_10_Event.)

Public method

remove_BeforeAutoSave

(Inherited from ItemEvents_10_Event.)

Public method

remove_BeforeCheckNames

(Inherited from ItemEvents_10_Event.)

Public method

remove_BeforeDelete

(Inherited from ItemEvents_10_Event.)

Public method

remove_Close

(Inherited from ItemEvents_10_Event.)

Public method

remove_CustomAction

(Inherited from ItemEvents_10_Event.)

Public method

remove_CustomPropertyChange

(Inherited from ItemEvents_10_Event.)

Public method

remove_Forward

(Inherited from ItemEvents_10_Event.)

Public method

remove_Open

(Inherited from ItemEvents_10_Event.)

Public method

remove_PropertyChange

(Inherited from ItemEvents_10_Event.)

Public method

remove_Read

(Inherited from ItemEvents_10_Event.)

Public method

remove_Reply

(Inherited from ItemEvents_10_Event.)

Public method

remove_ReplyAll

(Inherited from ItemEvents_10_Event.)

Public method

remove_Send

(Inherited from ItemEvents_10_Event.)

Public method

remove_Unload

(Inherited from ItemEvents_10_Event.)

Public method

remove_Write

(Inherited from ItemEvents_10_Event.)

Public method

Reply

Creates a reply, pre-addressed to the original sender, from the original message. (Inherited from _MailItem.)

Public method

ReplyAll

Creates a reply to all original recipients from the original message. (Inherited from _MailItem.)

Public method

Save

Saves the Microsoft Outlook item to the current folder or, if this is a new item, to the Outlook default folder for the item type. (Inherited from _MailItem.)

Public method

SaveAs

Saves the Microsoft Outlook item to the specified path and in the format of the specified file type. If the file type is not specified, the MSG format (.msg) is used. (Inherited from _MailItem.)

Public method

Send

Sends the e-mail message. (Inherited from _MailItem.)

Public method

ShowCategoriesDialog

Displays the Show Categories dialog box, which allows you to select categories that correspond to the subject of the item. (Inherited from _MailItem.)

Top

Events

 

Name

Description

Public event

AttachmentAdd

Occurs when an attachment has been added to an instance of the parent object. (Inherited from ItemEvents_10_Event.)

Public event

AttachmentRead

Occurs when an attachment in an instance of the parent object has been opened for reading. (Inherited from ItemEvents_10_Event.)

Public event

AttachmentRemove

Occurs when an attachment has been removed from an instance of the parent object. (Inherited from ItemEvents_10_Event.)

Public event

BeforeAttachmentAdd

Occurs before an attachment is added to an instance of the parent object. (Inherited from ItemEvents_10_Event.)

Public event

BeforeAttachmentPreview

Occurs before an attachment associated with an instance of the parent object is previewed. (Inherited from ItemEvents_10_Event.)

Public event

BeforeAttachmentRead

Occurs before an attachment associated with an instance of the parent object is read from the file system, an attachment stream, or an Attachment object. (Inherited from ItemEvents_10_Event.)

Public event

BeforeAttachmentSave

Occurs just before an attachment is saved. (Inherited from ItemEvents_10_Event.)

Public event

BeforeAttachmentWriteToTempFile

Occurs before an attachment associated with an instance of the parent object is written to a temporary file. (Inherited from ItemEvents_10_Event.)

Public event

BeforeAutoSave

Occurs before the item is automatically saved by Outlook. (Inherited from ItemEvents_10_Event.)

Public event

BeforeCheckNames

Occurs just before Microsoft Outlook starts resolving names in the recipient collection for an item (which is an instance of the parent object). (Inherited from ItemEvents_10_Event.)

Public event

BeforeDelete

Occurs before an item (which is an instance of the parent object) is deleted. (Inherited from ItemEvents_10_Event.)

Public event

Close

Occurs when the inspector associated with an item (which is an instance of the parent object) is being closed. (Inherited from ItemEvents_10_Event.)

Public event

CustomAction

Occurs when a custom action of an item (which is an instance of the parent object) executes. (Inherited from ItemEvents_10_Event.)

Public event

CustomPropertyChange

Occurs when a custom property of an item (which is an instance of the parent object) is changed. (Inherited from ItemEvents_10_Event.)

Public event

Forward

Occurs when the user selects the Forward action for an item (which is an instance of the parent object). (Inherited from ItemEvents_10_Event.)

Public event

Open

Occurs when an instance of the parent object is being opened in an Inspector. (Inherited from ItemEvents_10_Event.)

Public event

PropertyChange

Occurs when an explicit built-in property of an instance of the parent object is changed. (Inherited from ItemEvents_10_Event.)

Public event

Read

Occurs when an instance of the parent object is opened for editing by the user. (Inherited from ItemEvents_10_Event.)

Public event

Reply

Occurs when the user selects the Reply action for an item (which is an instance of the parent object). (Inherited from ItemEvents_10_Event.)

Public event

ReplyAll

Occurs when the user selects the ReplyAll action for an item (which is an instance of the parent object). (Inherited from ItemEvents_10_Event.)

Public event

Send

Occurs when the user selects the Send action for an item (which is an instance of the parent object). (Inherited from ItemEvents_10_Event.)

Public event

Unload

Occurs before an Outlook item is unloaded from memory, either programmatically or by user action. (Inherited from ItemEvents_10_Event.)

Public event

Write

Occurs when an instance of the parent object is saved, either explicitly or implicitly (for example, in response to a prompt when closing the item's inspector). (Inherited from ItemEvents_10_Event.)

Top

See Also

Reference

MailItem Interface

Microsoft.Office.Interop.Outlook Namespace