Conversation Interface

Definition

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Represents a conversation that includes one or more items stored in one or more folders and stores.

public interface class Conversation : Microsoft::Office::Interop::Outlook::_Conversation

[System.Runtime.InteropServices.Guid("00063101-0000-0000-C000-000000000046")]
public interface Conversation : Microsoft.Office.Interop.Outlook._Conversation

Public Interface Conversation
Implements _Conversation

Derived

Microsoft.Office.Interop.Outlook.ConversationClass

Attributes

GuidAttribute

Implements

_Conversation

Remarks

This is a .NET interface derived from a COM coclass that is required by managed code for interoperability with the corresponding COM object. Use this derived interface to access all method, property, and event members of the COM object. However, if a method or event you want to use shares the same name under the same COM object, cast to the corresponding primary interface to call the method, and cast to the latest events interface to connect to the event. Refer to this topic for information about the COM object. For information about the method and property members of the COM object, see _Conversation.

The Conversation object is an abstract, aggregated object. Although a conversation can include items of different types, the Conversation object does not correspond to a particular underlying MAPI IMessage : IMAPIProp object.

A conversation represents one or more items in one or more folders and stores. If you move an item in a conversation to the Deleted Items folder and subsequently enumerate the conversation by using the GetChildren(Object), GetRootItems(), or GetTable() method, the item will not be included in the returned object.

To obtain a Conversation object for an existing conversation, use the GetConversation method of the item.

There are actions that you can apply to items in a conversation by calling the SetAlwaysAssignCategories(String, Store), SetAlwaysDelete(OlAlwaysDeleteConversation, Store), or SetAlwaysMoveToFolder(MAPIFolder, Store) method. Each of these actions is applied to all items in the conversation automatically when the method is called; the action is also applied to future items in the conversation as long as the action is still applicable to the conversation. There is no explicit save method on the Conversation object.

Also, when you apply an action to items in a conversation, the corresponding event occurs. For example, the ItemChange event of the Items object occurs when you call SetAlwaysAssignCategories, and the BeforeItemMove event of the Folder object occurs when you call SetAlwaysMoveToFolder.

Properties

Application	Returns an Application object that represents the parent Microsoft Outlook application for the Conversation object. Read-only. (Inherited from _Conversation)
Class	Returns an OlObjectClass constant that indicates the object's class. Read-only. (Inherited from _Conversation)
ConversationID	Returns a String (string in C#) that uniquely identifies a Conversation object. Read-only. (Inherited from _Conversation)
Parent	Returns the parent Object (object in C#) of the specified Conversation object. Read-only. (Inherited from _Conversation)
Session	Returns the NameSpace object for the current session. Read-only. (Inherited from _Conversation)

Methods

ClearAlwaysAssignCategories(Store)	Removes all categories from all items in the conversation and stops the action of always assigning categories to items in the conversation. (Inherited from _Conversation)
GetAlwaysAssignCategories(Store)	Returns a String (string in C#) that indicates the category or categories that are assigned to all new items that arrive in the conversation. (Inherited from _Conversation)
GetAlwaysDelete(Store)	Returns a constant in the OlAlwaysDeleteConversation enumeration that indicates whether all new items that join the conversation are always moved to the Deleted Items folder in the specified delivery store. (Inherited from _Conversation)
GetAlwaysMoveToFolder(Store)	Returns a Folder object that indicates the folder in the specified delivery store to which new items that arrive in the conversation are always moved. (Inherited from _Conversation)
GetChildren(Object)	Returns a SimpleItems collection that contains all items under the specified conversation node. (Inherited from _Conversation)
GetParent(Object)	Returns the parent item of the specified node in the conversation. (Inherited from _Conversation)
GetRootItems()	Returns a SimpleItems collection that contains all root items in the conversation. (Inherited from _Conversation)
GetTable()	Returns a Table object that contains rows that represent all items in the conversation. (Inherited from _Conversation)
MarkAsRead()	Marks all items in the conversation as read. (Inherited from _Conversation)
MarkAsUnread()	Marks all items in the conversation as unread. (Inherited from _Conversation)
SetAlwaysAssignCategories(String, Store)	Applies one or more categories to all existing items and future items of the conversation. (Inherited from _Conversation)
SetAlwaysDelete(OlAlwaysDeleteConversation, Store)	Specifies a setting for the specified delivery store that indicates whether all existing items and all new items that arrive in the conversation are always moved to the Deleted Items folder in the specified delivery store. (Inherited from _Conversation)
SetAlwaysMoveToFolder(MAPIFolder, Store)	Sets a Folder object that indicates the folder to which all existing conversation items and new items that arrive in the conversation are always moved. (Inherited from _Conversation)
StopAlwaysDelete(Store)	Stops the action of always moving conversation items in the specified store to the Deleted Items folder in that store. (Inherited from _Conversation)
StopAlwaysMoveToFolder(Store)	Stops the action of always moving conversation items in the specified store to a specific folder. (Inherited from _Conversation)