Integrar Outlook y C#

Outlook es una aplicación para organizar y manejar correos, tareas, contactos, recordatorios, etc.

Podemos usar C# para enviar, listar, leer correos, y otras acciones que generalmente hacemos con Outlook, por ejemplo, si queremos tener una aplicación, y en esa aplicación tener una opción para estar leyendo los correos, o enviar correos, además de obtener la lista de los contactos, adicionar contactos.

Manos a la obra!

–          Creamos un nuevo proyecto en Visual Studio

–          Se debe importar la referencia Microsoft.Office.Interop.Outlook:

Ahora creamos la interfaz grafica, la mía es esta, no es muy buena pero al menos sirve para mostrar algunas cosas 😛 :

Lo que tengo pensado hacer es:

–          Listar correos (Asunto, Remitente, Texto, Hora)

–          Listar Contactos

–          Adicionar y Modificar un contacto

–          Eliminar un contacto

–          Enviar un Correo

–          Y una que otra información que podamos obtener del OutLook

En el código, lo que hacemos es:

–          Declarar una variable que será el objeto de la aplicación Outlook

–          Obtener el Namespace de la aplicación sobre la cual trabajamos

En el código declaramos como variables globales los siguientes objetos:

Microsoft.Office.Interop.Outlook.Application outlookApp = new Microsoft.Office.Interop.Outlook.Application();
NameSpace outlookNS = null;
MAPIFolder mails = null;

En el constructor inicializamos los objetos:

outlookNS = outlookApp.GetNamespace("MAPI");
mails = outlookNS.GetDefaultFolder(OlDefaultFolders.olFolderInbox);

Al enviar la cadena “MAPI” estamos obteniendo, los datos del namespace, actualmente MAPI es el único namespace valido.

El objeto MAPIFolder, representa una carpeta de Outlook, una carpeta puede contener otras carpetas y así sucesivamente, el método GetDefaultFolder(índice), donde índice es el número de la carpeta del espacio de nombre actual.

Mostrar los correos:

Para mostrar los correos que tenemos en nuestra carpeta inbox, debemos recorrer la carpeta, obtener los ítems,  verificar que sean de tipo MailItem y luego mostrar los datos.

Los objetos ítem de la clase MAPIFolder, pueden ser Notas, Citas, Post, Correos, Recordatorios, Tareas, etc., por eso debemos intentar convertirlos en MailItem para luego obtener sus características, si no hacemos esto se lanzara una excepción.

foreach (object obj in mails.Items)
{
  MailItem item = obj as MailItem;
  if (item != null)
  {
   listView1.Items.Add("Hora :" + item.ReceivedTime + " , Remitente :" + item.SenderName + " , Asunto :" + item.Subject);
  }
}

Mostrar los correos de una carpeta determinada:

En muchos casos tenemos muchas carpetas dentro de la carpeta Inbox, para poder categorizar los correos, en el ejemplo anterior, se obtenían todos los correos, pero si queremos mostrar solo los de una en especifica debemos hacer lo siguiente:

string folderName = "PruebaCorreos";
try
 {
  outlookApp.ActiveExplorer().CurrentFolder = mails.Folders[folderName];
  label3.Text = "Total de Correos: " + outlookApp.ActiveExplorer().CurrentFolder.Items.Count.ToString();
  foreach (object obj in outlookApp.ActiveExplorer().CurrentFolder.Items)
   {
     MailItem item = obj as MailItem;
     if (item != null)
      {
       listView1.Items.Add(item.Subject);
      }
    }
  }
catch
  {
   MessageBox.Show("No existe una carpeta llamada:  " + folderName + ".");
   }

Hemos cambiado el control ListBox por un ListView debido a que tenemos más opciones.

Debemos tener en cuenta que la carpeta: “PruebaCorreos” debe existir dentro de la carpeta Inbox:

Si copiamos esto en el botón de Ver Correos y luego ejecutamos:

Al ejecutar, se van a mostrar los correos que se encuentren en la carpeta “PruebaCorreos”, como dato si ven en el campo de Información General, aparecen que hay en total 4 correos, lo cual es mentira, existen 4 Items, de los cuales 3 son correos, por lo tanto debemos especificar en el count que los ítems que va a buscar son de la clase MailItem:

Items Correos = outlookApp.ActiveExplorer().CurrentFolder.Items.Restrict("[MessageClass]='IPM.Note'");
label3.Text = "Total de Correos: " + Correos.Count.ToString();

El metodo Restrict, permite tener un filtro para hacer una busqueda, el filtro que aplicamos es el tipo de la clase del Item, para los correos el tipo es IPM.Note, la lista completa de los tipos de Item en esta página: http://msdn.microsoft.com/en-us/library/bb176446.aspx

Podemos aplicar más filtros, para mostrar los mensajes que no han sido leidos, además modificar la inserción de los correos, para que si el correo no está leído, pintar la fila de un color diferente:

label1.Text = "Correos No Leidos: " + Correos.Restrict("[Unread]=true").Count.ToString();
foreach (object obj in outlookApp.ActiveExplorer().CurrentFolder.Items)
{
 MailItem item = obj as MailItem;
 if (item != null)
 {
  if (item.UnRead)
  {
   ListViewItem unreadItem = new ListViewItem();
   unreadItem.BackColor = Color.Yellow;
   unreadItem.Text = item.Subject;
   listView1.Items.Add(unreadItem);
  }
  else
  {
   listView1.Items.Add("* " + item.Subject);
  }
 }
}

Si vemos en Outlook, podemos ver los correos que no estan leidos:

Y en la aplicación:

Ahora lo que queda es hacer que al presionar uno de los correos, se nos muestre la información.

Hacemos doble clic sobre el control ListView, y escribimos lo siguiente:

private void listView1_SelectedIndexChanged(object sender, EventArgs e)
{
 String filtro = "";
 for (int i = 0; i < listView1.Items.Count; i++)
 {
  if (listView1.Items[i].Selected)
  {
    filtro = listView1.Items[i].Text;
  }
 }
 string folderName = "PruebaCorreos";
 outlookApp.ActiveExplorer().CurrentFolder = mails.Folders[folderName];
 object seleccionado = outlookApp.ActiveExplorer().CurrentFolder.Items.Find("[Subject] = '" + filtro + "'");
 if (seleccionado != null)
 {
  MailItem Mail = seleccionado as MailItem;
  if (Mail != null)
  {
   label4.Text = "Remitente: " + Mail.SenderName;
   label5.Text = "Hora envio: " + Mail.ReceivedTime;
   label6.Text = "Correo Remitente: " + Mail.SenderEmailAddress;
   Mail.BodyFormat = OlBodyFormat.olFormatRichText;
   richTextBox1.Text = Mail.Body;
  }
 }
}

Al ejecutar el código puede que nos aparezca este mensaje de advertencia para poder ingresar a los datos de Outlook:

Al permitir el acceso tenemos:

Por el momento dejamos hasta aquí, en la siguiente entrada listaremos, agregamos y eliminamos contactos, y enviamos correos.

Codigo Fuente AQUI.

Referencias.

http://msdn.microsoft.com/en-us/library/aa289167(VS.71).aspx

http://msdn.microsoft.com/en-us/library/ms268869(VS.80).aspx