_MailItem Interface
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
This is a primary interface in a COM coclass that is required by managed code for interoperability with the corresponding COM object. Use this primary interface only when the method you want to use shares the same name as an event of the COM object; in this case, cast to this interface to call the method, and cast to the latest events interface to connect to the event. Otherwise, use the .NET interface that is derived from the COM coclass to access methods, properties, and events of the COM object. For information about the COM object, see MailItem.
public interface class _MailItem
[System.Runtime.InteropServices.Guid("00063034-0000-0000-C000-000000000046")]
public interface _MailItem
Public Interface _MailItem
- Derived
- Attributes
Properties
Actions |
Returns an Actions collection that represents all the available actions for the item. Read-only. |
AlternateRecipientAllowed |
Returns a Boolean (bool in C#) that is True if the mail message can be forwarded. Read/write. |
Application |
Returns an Application object that represents the parent Outlook application for the object. Read-only. |
Attachments |
Returns an Attachments object that represents all the attachments for the specified item. Read-only. |
AutoForwarded |
A Boolean (bool in C#) value that returns True if the item was automatically forwarded. Read/write. |
AutoResolvedWinner |
Returns a Boolean (bool in C#) that determines if the item is a winner of an automatic conflict resolution. Read-only. |
BCC |
Returns a String (string in C#) representing the display list of blind carbon copy (BCC) names for a MailItem. Read/write. |
BillingInformation |
Returns or sets a String (string in C#) representing the billing information associated with the Outlook item. Read/write. |
Body |
Returns or sets a String (string in C#) representing the clear-text body of the Outlook item. Read/write. |
BodyFormat |
Returns or sets an OlBodyFormat constant indicating the format of the body text. Read/write. |
Categories |
Returns or sets a String (string in C#) representing the categories assigned to the Outlook item. Read/write. |
CC |
Returns a String (string in C#) representing the display list of carbon copy (CC) names for a MailItem. Read/write. |
Class |
Returns an OlObjectClass constant indicating the object's class. Read-only. |
Companies |
Returns or sets a String (string in C#) representing the names of the companies associated with the Outlook item. Read/write. |
Conflicts |
Return the Conflicts object that represents the items that are in conflict for any Outlook item object. Read-only. |
ConversationID |
Returns a String (string in C#) that uniquely identifies a Conversation object that the MailItem object belongs to. Read-only. |
ConversationIndex |
Returns a String (string in C#) representing the index of the conversation thread of the Outlook item. Read-only. |
ConversationTopic |
Returns a String (string in C#) representing the topic of the conversation thread of the Outlook item. Read-only. |
CreationTime |
Returns a DateTime indicating the creation time for the Outlook item. Read-only. |
DeferredDeliveryTime |
Returns or sets a DateTime indicating the date and time the mail message is to be delivered. Read/write. |
DeleteAfterSubmit |
Returns or sets a Boolean (bool in C#) value 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. |
DownloadState |
Returns a constant that belongs to the OlDownloadState enumeration indicating the download state of the item. Read-only. |
EnableSharedAttachments |
This object, member, or enumeration is deprecated and is not intended to be used in your code. |
EntryID |
Returns a String (string in C#) representing the unique Entry ID of the object. Read-only. |
ExpiryTime |
Returns or sets a DateTime indicating the date and time at which the item becomes invalid and can be deleted. Read/write. |
FlagDueBy |
This object, member, or enumeration is deprecated and is not intended to be used in your code. |
FlagIcon |
This object, member, or enumeration is deprecated and is not intended to be used in your code. |
FlagRequest |
Returns or sets a String (string in C#) that indicates the requested action for a mail item. Read/write. |
FlagStatus |
This object, member, or enumeration is deprecated and is not intended to be used in your code. |
FormDescription |
Returns the FormDescription object that represents the form description for the specified Outlook item. Read-only. |
GetInspector |
Returns an Inspector object that represents an inspector initialized to contain the specified item. Read-only. |
HasCoverSheet |
This object, member, or enumeration is deprecated and is not intended to be used in your code. |
HTMLBody |
Returns or sets a String (string in C#) representing the HTML body of the specified item. Read/write. |
Importance |
Returns or sets an OlImportance constant indicating the relative importance level for the Outlook item. Read/write. |
InternetCodepage |
Returns or sets an Integer (int in C#) value that determines the Internet code page used by the item. Read/write. |
IsConflict |
Returns a Boolean (bool in C#) that determines if the item is in conflict. Read-only. |
IsIPFax |
This object, member, or enumeration is deprecated and is not intended to be used in your code. |
IsMarkedAsTask |
Returns a Boolean (bool in C#) value that indicates whether the MailItem is marked as a task. Read-only. |
ItemProperties |
Returns an ItemProperties collection that represents all standard and user-defined properties associated with the Outlook item. Read-only. |
LastModificationTime |
Returns a DateTime specifying the date and time that the Outlook item was last modified. Read-only. |
Links |
This object, member, or enumeration is deprecated and is not intended to be used in your code. |
MAPIOBJECT |
This object, member, or enumeration is deprecated and is not intended to be used in your code. |
MarkForDownload |
Returns or sets an OlRemoteStatus constant that determines the status of an item once it is received by a remote user. Read/write. |
MessageClass |
Returns or sets a String (string in C#) representing the message class for the Outlook item. Read/write. |
Mileage |
Returns or sets a String (string in C#) representing the mileage for an item. Read/write. |
NoAging |
Returns or sets a Boolean (bool in C#) value that is True to not age the Outlook item. Read/write. |
OriginatorDeliveryReportRequested |
Returns or sets a Boolean (bool in C#) value that determines whether the originator of the meeting item or mail message will receive a delivery report. Read/write. |
OutlookInternalVersion |
Returns an Integer (int in C#) value representing the build number of the Outlook application for an Outlook item. Read-only. |
OutlookVersion |
Returns a String (string in C#) indicating the major and minor version number of the Outlook application for an Outlook item. Read-only. |
Parent |
Returns the parent Object of the specified object. Read-only. |
Permission |
Sets or returns an OlPermission constant that determines the permissions the recipients will have on the e-mail item. Read/write. |
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. |
PermissionTemplateGuid |
Returns or sets a String (string in C#) value that represents the GUID of the template file to apply to the MailItem in order to specify Information Rights Management (IRM) permissions. Read/write. |
PropertyAccessor |
Returns a PropertyAccessor object that supports creating, getting, setting, and deleting properties of the parent MailItem object. Read-only. |
ReadReceiptRequested |
Returns a Boolean (bool in C#) value that indicates True if a read receipt has been requested by the sender. |
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. |
ReceivedByName |
Returns a String (string in C#) representing the display name of the true recipient for the mail message. Read-only. |
ReceivedOnBehalfOfEntryID |
Returns a String (string in C#) representing the EntryID of the user delegated to represent the recipient for the mail message. Read-only. |
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. |
ReceivedTime |
Returns a DateTime indicating the date and time at which the item was received. Read-only. |
RecipientReassignmentProhibited |
Returns a Boolean (bool in C#) that indicates True if the recipient cannot forward the mail message. Read/write. |
Recipients |
Returns a Recipients collection that represents all the recipients for the Outlook item. Read-only. |
ReminderOverrideDefault |
Returns or sets a Boolean (bool in C#) value that is True if the reminder overrides the default reminder behavior for the item. Read/write. |
ReminderPlaySound |
Returns or sets a Boolean (bool in C#) value that is True if the reminder should play a sound when it occurs for this item. Read/write. |
ReminderSet |
Returns or sets a Boolean (bool in C#) value that is True if a reminder has been set for this item. Read/write. |
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. |
ReminderTime |
Returns or sets a DateTime indicating the date and time at which the reminder should occur for the specified item. Read/write. |
RemoteStatus |
Returns or sets an OlRemoteStatus constant specifying the remote status of the mail message. Read/write. |
ReplyRecipientNames |
Returns a semicolon-delimited String (string in C#) list of reply recipients for the mail message. Read-only. |
ReplyRecipients |
Returns a Recipients collection that represents all the reply recipient objects for the Outlook item. Read-only. |
RetentionExpirationDate |
Returns a DateTime value that specifies the date when the MailItem object expires, after which the Messaging Records Management (MRM) Assistant will delete the item. Read-only. |
RetentionPolicyName |
Returns a String (string in C#) that specifies the name of the retention policy. Read-only. |
RTFBody |
Returns or sets a byte array that represents the body of the Microsoft Outlook item in Rich Text Format. Read/write. |
Saved |
Returns a Boolean (bool in C#) value that is True if the Outlook item has not been modified since the last save. Read-only. |
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. |
Sender |
Returns or sets an AddressEntry object that corresponds to the user of the account from which the MailItem is sent. Read/write. |
SenderEmailAddress |
Returns a String (string in C#) that represents the e-mail address of the sender of the Outlook item. Read-only. |
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. |
SenderName |
Returns a String (string in C#) indicating the display name of the sender for the Outlook item. Read-only. |
SendUsingAccount |
Returns or sets an Account object that represents the account under which the MailItem is to be sent. Read/write. |
Sensitivity |
Returns or sets a constant in the OlSensitivity enumeration indicating the sensitivity for the Outlook item. Read/write. |
Sent |
Returns a Boolean (bool in C#) value that indicates if a message has been sent. Read-only. |
SentOn |
Returns a DateTime indicating the date and time on which the Outlook item was sent. Read-only. |
SentOnBehalfOfName |
Returns a String (string in C#) indicating the display name for the intended sender of the mail message. Read/write. |
Session |
Returns the NameSpace object for the current session. Read-only. |
Size |
Returns an Integer (int in C#) value indicating the size (in bytes) of the Outlook item. Read-only. |
Subject |
Returns or sets a String (string in C#) indicating the subject for the Outlook item. Read/write. |
Submitted |
Returns a Boolean (bool in C#) value that is True if the item has been submitted. Read-only. |
TaskCompletedDate |
Returns or sets a DateTime value that represents the completion date of the task for this MailItem. Read/write. |
TaskDueDate |
Returns or sets a DateTime value that represents the due date of the task for this MailItem. Read/write. |
TaskStartDate |
Returns or sets a DateTime value that represents the start date of the task for this MailItem object. Read/write. |
TaskSubject |
Returns or sets a String (string in C#) value that represents the subject of the task for the MailItem object. Read/write. |
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. |
ToDoTaskOrdinal |
Returns or sets a DateTime value that represents the ordinal value of the task for the MailItem. Read/write. |
UnRead |
Returns or sets a Boolean (bool in C#) value that is True if the Outlook item has not been opened (read). Read/write. |
UserProperties |
Returns the UserProperties collection that represents all the user properties for the Outlook item. Read-only. |
VotingOptions |
Returns or sets a String (string in C#) specifying a delimited string containing the voting options for the mail message. Read/write. |
VotingResponse |
Returns or sets a String (string in C#) specifying the voting response for the mail message. Read/write. |
Methods
AddBusinessCard(ContactItem) |
Appends contact information based on the Electronic Business Card (EBC) associated with the specified ContactItem object to the MailItem object. |
ClearConversationIndex() |
Clears the index of the conversation thread for the mail message. |
ClearTaskFlag() |
Clears the MailItem object as a task. |
Close(OlInspectorClose) |
Closes and optionally saves changes to the Outlook item. |
Copy() |
Creates another instance of an object. |
Delete() |
Removes the item from the folder that contains the item. |
Display(Object) |
Displays a new Inspector object for the item. |
Forward() |
Executes the Forward action for an item and returns the resulting copy as a MailItem object. |
GetConversation() |
Obtains a Conversation object that represents the conversation to which this item belongs. |
MarkAsTask(OlMarkInterval) |
Marks a MailItem object as a task and assigns a task interval for the object. |
Move(MAPIFolder) |
Moves a Microsoft Outlook item to a new folder. |
PrintOut() |
Prints the Outlook item using all default settings. The PrintOut method is the only Outlook method that can be used for printing. |
Reply() |
Creates a reply, pre-addressed to the original sender, from the original message. |
ReplyAll() |
Creates a reply to all original recipients from the original message. |
Save() |
Saves the Outlook item to the current folder or, if this is a new item, to the Outlook default folder for the item type. |
SaveAs(String, Object) |
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. |
Send() |
Sends the e-mail message. |
ShowCategoriesDialog() |
Displays the Show Categories dialog box, which allows you to select categories that correspond to the subject of the item. |