Método MailItem.GetConversation (Outlook)
Obtém um objeto Conversation que representa a conversa à qual este item pertence.
Sintaxe
expression. GetConversation
Expressão Uma variável que representa um objeto 'MailItem'.
Valor de retorno
Um objeto Conversation que representa a conversa à qual este item pertence.
Comentários
GetConversation retorna Null (Nothing no Visual Basic) se a conversa existir para o item. Nenhuma conversa existe para um item nos seguintes cenários:
O item não foi salvo. Um item pode ser salvo programaticamente, com a ação do usuário ou de salvamento automático.
Para um item que pode ser enviado (por exemplo, um item de email, item de compromisso ou item de contato), o item não não foi enviado.
As conversas foram desabilitadas por meio do Registro do Windows.
O repositório não dá suporte ao modo de exibição Conversa (por exemplo, o Outlook está sendo executado em modo clássico online em uma versão do Microsoft Exchange anterior a Microsoft Exchange Server 2010). Use a propriedade IsConversationEnabled do objeto Store para determinar se o repositório dá suporte ao modo de exibição Conversa.
Exemplo
The following managed code is written in C#. To run a .NET Framework managed code sample that needs to call into a Component Object Model (COM), you must use an interop assembly that defines and maps managed interfaces to the COM objects in the object model type library. For Outlook, you can use Visual Studio and the Outlook Primary Interop Assembly (PIA). Before you run managed code samples for Outlook 2013, ensure that you have installed the Outlook 2013 PIA and have added a reference to the Microsoft Outlook 15.0 Object Library component in Visual Studio. Você deve usar o código a ThisAddIn seguir na classe de um suplemento do Outlook (usando ferramentas de desenvolvedor do Office para Visual Studio). The Application object in the code must be a trusted Outlook Application object provided by ThisAddIn.Globals. For more information about using the Outlook PIA to develop managed Outlook solutions, see the Outlook 2013 Primary Interop Assembly Reference on MSDN.
O exemplo de código a seguir pressupõe que o item selecionado na janela do explorer é um item de email. O exemplo de código obtém a conversa que o item de email selecionado está associado e enumera cada item na conversa, exibindo o assunto do item. O DemoConversation método chama o método GetConversation do item de email selecionado para obter o objeto Conversation associado. DemoConversation chama os métodos GetTable e GetRootItems do objeto Conversation para obter um objeto Table e a coleção SimpleItems, respectivamente. DemoConversation chama o método recorrentes EnumerateConversation para enumerar e exibir o assunto de cada item na conversa.
void DemoConversation()
{
object selectedItem =
Application.ActiveExplorer().Selection[1];
// This example uses only
// MailItem. Other item types such as
// MeetingItem and PostItem can participate
// in the conversation.
if (selectedItem is Outlook.MailItem)
{
// Cast selectedItem to MailItem.
Outlook.MailItem mailItem =
selectedItem as Outlook.MailItem;
// Determine the store of the mail item.
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 the 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 the 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 the 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 the 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);
}
}
}
Confira também
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.