Abrufen und Anzeigen von Elementen in einer Unterhaltung
In diesem Beispiel wird veranschaulicht, wie E-Mail-Elemente in einer Unterhaltung abgerufen und angezeigt werden.
Beispiel
Im folgenden Codebeispiel ruft DemoConversation ein MailItem-Objekt ab und ermittelt dann den Speicher des MailItem-Objekts unter Verwendung der Store-Eigenschaft des Folder-Objekts. DemoConversation überprüft dann, ob die IsConversationEnabled-Eigenschaft auf true festgelegt it; wenn sie auf true festgelegt ist, ruft das Codebeispiel das Conversation-Objekt mithilfe der GetConversation()-Methode ab. Wenn das Conversation-Objekt kein Nullverweis ist, ruft das Beispiel das zugeordnete Table-Objekt mithilfe der GetTable()-Methode ab, das jedes Element in der Unterhaltung enthält.
Im Beispiel wird dann jedes Element in der Tabelle aufgeführt und EnumerateConversation für jedes Element aufgerufen, um auf die untergeordneten Knoten jedes Elements zuzugreifen. EnumerateConversation verwendet ein Conversation-Objekt und ruft die untergeordneten Knoten mit der GetChildren(Object)-Methode auf. EnumerateConversation wird rekursiv aufgerufen, bis keine weiteren untergeordneten Knoten vorhanden sind. Jedes Element der Unterhaltung wird dann für den Benutzer angezeigt.
Wenn Sie Visual Studio verwenden, um dieses Codebeispiel zu testen, müssen Sie der Microsoft Outlook 15.0-Objektbibliothekkomponente zuerst einen Verweis hinzufügen und die Outlook-Variable angeben, wenn Sie den Microsoft.Office.Interop.Outlook-Namespace importieren. Die using-Anweisung darf im Codebeispiel nicht direkt vor den Funktionen stehen, sondern muss vor der öffentlichen Class-Deklaration hinzugefügt werden. Die folgende Codezeile zeigt, wie Sie den Import und die Zuweisung in C# vornehmen.
using Outlook = Microsoft.Office.Interop.Outlook;
void DemoConversation()
{
object selectedItem =
Application.ActiveExplorer().Selection[1];
// For this example, you will work only with
//MailItem. Other item types such as
//MeetingItem and PostItem can participate
//in Conversation.
if (selectedItem is Outlook.MailItem)
{
// Cast selectedItem to MailItem.
Outlook.MailItem mailItem =
selectedItem as Outlook.MailItem; ;
// Determine store of mailItem.
Outlook.Folder folder = mailItem.Parent
as Outlook.Folder;
Outlook.Store store = folder.Store;
if (store.IsConversationEnabled == true)
{
// Obtain a Conversation object.
Outlook.Conversation conv =
mailItem.GetConversation();
// Check for null Conversation.
if (conv != null)
{
// Obtain Table that contains rows
// for each item in Conversation.
Outlook.Table table = conv.GetTable();
Debug.WriteLine("Conversation Items Count: " +
table.GetRowCount().ToString());
Debug.WriteLine("Conversation Items from Table:");
while (!table.EndOfTable)
{
Outlook.Row nextRow = table.GetNextRow();
Debug.WriteLine(nextRow["Subject"]
+ " Modified: "
+ nextRow["LastModificationTime"]);
}
Debug.WriteLine("Conversation Items from Root:");
// Obtain root items and enumerate Conversation.
Outlook.SimpleItems simpleItems
= conv.GetRootItems();
foreach (object item in simpleItems)
{
// In this example, enumerate only MailItem type.
// Other types such as PostItem or MeetingItem
// can appear in Conversation.
if (item is Outlook.MailItem)
{
Outlook.MailItem mail = item
as Outlook.MailItem;
Outlook.Folder inFolder =
mail.Parent as Outlook.Folder;
string msg = mail.Subject
+ " in folder " + inFolder.Name;
Debug.WriteLine(msg);
}
// Call EnumerateConversation
// to access child nodes of root items.
EnumerateConversation(item, conv);
}
}
}
}
}
void EnumerateConversation(object item,
Outlook.Conversation conversation)
{
Outlook.SimpleItems items =
conversation.GetChildren(item);
if (items.Count > 0)
{
foreach (object myItem in items)
{
// In this example, enumerate only MailItem type.
// Other types such as PostItem or MeetingItem
// can appear in Conversation.
if (myItem is Outlook.MailItem)
{
Outlook.MailItem mailItem =
myItem as Outlook.MailItem;
Outlook.Folder inFolder =
mailItem.Parent as Outlook.Folder;
string msg = mailItem.Subject
+ " in folder " + inFolder.Name;
Debug.WriteLine(msg);
}
// Continue recursion.
EnumerateConversation(myItem, conversation);
}
}
}