Como recuperar mensagens específicas usando o método Find e o método Restrict no Visual C #

Resumo

Este artigo descreve como usar a Biblioteca de Objetos do Microsoft Outlook 10.0 para recuperar mensagens específicas usando o método Find e o método Restrict no Microsoft Visual C#.

Informações adicionais

Para usar o Microsoft Outlook Biblioteca de Objetos 10.0 para recuperar mensagens específicas, siga estas etapas:

1. Inicie Microsoft Visual Studio .NET ou Microsoft Visual Studio 2005.

2. No menu Arquivo, aponte para Novo e clique em Project.

3. Na lista Tipos C# Visual, clique em Aplicativo de Console.
   
   Por padrão, o arquivo Class1.cs é criado.
   
   Observação No Microsoft Visual C# 2005, clique em Visual C#" na lista Tipos de projetos do Visual C#. Por padrão, Program.cs é criado.

4. Adicione uma referência à Biblioteca de Objetos do Microsoft Outlook 10.0. Para fazer isso, siga estas etapas:

   1. No menu Project, clique em Add Reference.

   2. Clique na guia COM, localize o Microsoft Outlook Biblioteca de Objetos 10.0 e clique em Selecionar.
      
      Observação no Microsoft Visual C# 2005. você não precisa clicar em Selecionar.

   3. Na caixa de diálogo Adicionar Referências , clique em OK.

   4. Se você for solicitado a gerar wrappers para as bibliotecas selecionadas, clique em Sim.

5. Na janela de código, substitua o código pelo seguinte:

   using System;
   using System.Reflection;     // to use Missing.Value
   
   namespace FilterAppointments
   {
      /// <summary>
      /// Summary description for Class1.
      /// </summary>
      class Class1
      {
         /// <summary>
         /// The main entry point for the application.
         /// </summary>
         [STAThread]
         public static int Main(string[] args)
         {
            try
            {
               // Create an Outlook application.
               Outlook.Application oApp = new Outlook.Application();
   
               // Get the Mapi NameSpace and the Logon.
               Outlook.NameSpace oNS = (Outlook.NameSpace)oApp.GetNamespace("mapi");
   
               // Log on using dialog to choose a profile.
               oNS.Logon(Missing.Value, Missing.Value, true, true); 
   
               // Alternate Logon using specific profile
               // TODO: Change the profile name where it is appropriate.
               //oNS.Logon("YourValidProfile", Missing.Value, false, true); 
   
               // Get the Calendar folder.
               Outlook.MAPIFolder oCalendar = oNS.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderCalendar);
   
               // Get the Items collection in the folder.
               Outlook.Items  oItems = (Outlook.Items)oCalendar.Items;
               Console.WriteLine("Total Items (unrestricted): " + oItems.Count);
   
               //Include all occurrences of recurring items, and then sort them.
               oItems.Sort ("[Start]", false);
               oItems.IncludeRecurrences = true;
   
               // Define the string for the search criteria.
               String sCriteria;
   
               // Set the criteria for the Date fields.
               sCriteria = "[Start] <= '09/01/2002 08:00 AM' and [End] >= '2/15/2002 08:00 PM'";
   
               // Set the criteria for a string field.
               // sCriteria = "[Subject] = 'Weekly recurring meeting'";
   
               // Set the criteria for a numeric field.
               // Look for meetings that have not been responded to.
               // sCriteria = "[ResponseStatus] = " + (Int32)Outlook.OlResponseStatus.olResponseNotResponded)
   
               // Use the Restrict method to reduce the number of items to process.
               Outlook.Items oRestrictedItems = oItems.Restrict(sCriteria);
               oRestrictedItems.Sort ("[Start]", false);
               oRestrictedItems.IncludeRecurrences = true;
   
               Console.WriteLine("Total Items Unrestricted : " + oRestrictedItems.Count);
   
               Outlook.AppointmentItem oAppointment;
   
               //Get each item until item is null.
               Outlook.AppointmentItem oAppt;
               oAppt = (Outlook.AppointmentItem)oRestrictedItems.GetFirst();
               while (oAppt != null)
               {
                  // Console.WriteLine(i.ToString());
                   Console.WriteLine("  Subject: " + oAppt.Subject.ToString());
                   Console.WriteLine("  Start time: " + oAppt.Start.ToString());
                   Console.WriteLine("  End time: " + oAppt.End.ToString());
                   Console.WriteLine("  Occurrences: " + oAppt.RecurrenceState.ToString());
                   Console.WriteLine("\n\n");
                   oAppt = (Outlook.AppointmentItem)oRestrictedItems.GetNext();
               }
   
   
               // Use the Find method to get single match.
               sCriteria = "[Start] >= '09/30/2001'"; 
               Console.WriteLine("Criteria: " + sCriteria.ToString());
               oAppointment = (Outlook.AppointmentItem)oItems.Find(sCriteria);
               Console.WriteLine("Used Find with Date fields");
               if (oAppointment is Outlook.AppointmentItem) 
                  Console.WriteLine("Found -> " + oAppointment.Subject.ToString());
               else
                  Console.WriteLine("No object found");
   
   
               // Log off
               oNS.Logoff();
   
               // Clean up
               oAppointment = null;
               oRestrictedItems = null;
               oItems = null;
               oCalendar = null;
               oNS = null;
               oApp = null;
            }
   
               //Simple error handling
            catch (Exception e)
            {
               Console.WriteLine("{0} Exception caught.", e);
            }  
   
            //Default return value
            return 0;
         }
      }
   }
   

6. Pesquise a cadeia de caracteres de texto TODO no código e modifique o código para seu ambiente.

7. Pressione a tecla F5 para criar e executar o programa.

Referências

Para obter mais informações sobre os recursos de segurança do Outlook 2002, clique no seguinte número de artigo para exibir o artigo na Base de Dados de Conhecimento da Microsoft:

290500 Descrição dos recursos de segurança de email relacionados ao desenvolvedor no Outlook 2002Para


obter informações adicionais sobre problemas que podem ocorrer quando você usar a propriedade Count de grandes coleções, clique no seguinte número de artigo para exibir o artigo na Base de Dados de Conhecimento da Microsoft:

294385 OL2002: propriedade Count incorreta usando compromissos recorrentes