Tutorial: Crear el primer complemento en el nivel de la aplicación para Outlook

Artículo
02/19/2013

En este tutorial se muestra cómo crear un complemento en el nivel de la aplicación para Microsoft Office Outlook.Las características que se crean en este tipo de solución están disponibles para la propia aplicación, con independencia del elemento de Outlook que esté abierto.Para obtener más información, vea Información general sobre el desarrollo de soluciones de Office.

Se aplica a: La información de este tema se aplica a los proyectos de nivel de aplicación para Outlook 2013 y Outlook 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

En este tutorial se muestran las tareas siguientes:

Crear un proyecto de complemento para Outlook.
Escribir código que utiliza el modelo de objetos de Outlook para agregar texto al asunto y al cuerpo de un nuevo mensaje de correo.
Compilar y ejecutar el proyecto para probarlo.
Limpiar el proyecto completado para que el complemento ya no se ejecute automáticamente en el equipo de desarrollo.

[!NOTA]

Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Valores de configuración de Visual Studio.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

Una edición de Visual Studio 2012 que incluye las herramientas para desarrolladores de Microsoft Office. Para obtener más información, vea [Configurar un equipo para desarrollar soluciones de Office](bb398242\(v=vs.110\).md).

Outlook 2013 o Outlook 2010.

Crear el proyecto

Para crear un nuevo proyecto de Outlook en Visual Studio

Inicie Visual Studio.
En el menú Archivo, elija Nuevo y haga clic en Proyecto.
En el panel de plantillas, expanda Visual c# o Visual Basicy, a continuación Office/SharePoint.
Bajo el nodo expandido Office/SharePoint , seleccione el nodo Office Agregar-INS .
En la lista de plantillas de proyecto, seleccione Complemento de Outlook 2010 o Complemento de Outlook 2013.
En el cuadro Nombre, escriba FirstOutlookAddIn.
Haga clic en Aceptar.

Visual Studio crea el proyecto FirstWordAddIn y abre el archivo de código ThisAddIn en el editor.

Escribir código que agrega texto a cada nuevo mensaje de correo

A continuación, agregue código al archivo de código ThisAddIn.El nuevo código utiliza el modelo de objetos de Outlook para agregar texto a cada nuevo mensaje de correo.De forma predeterminada, el archivo de código ThisAddIn contiene el código generado siguiente:

Una definición parcial de la clase ThisAddIn.Esta clase proporciona un punto de entrada para el código y proporciona acceso al modelo de objetos de Outlook.Para obtener más información, vea Programar complementos de nivel de aplicación.El resto de la clase ThisAddIn se define en un archivo de código oculto que no debe modificar.
Los controladores de eventos ThisAddIn_Startup y ThisAddIn_Shutdown.Se llama a estos controladores de eventos cuando Outlook carga y descarga el complemento.Use estos controladores de eventos para inicializar el complemento cuando éste se cargue y para limpiar los recursos cuando se descargue.Para obtener más información, vea Eventos de los proyectos de Office.

Para agregar texto al asunto y al cuerpo de cada nuevo mensaje de correo

En el archivo de código ThisAddIn, declare un campo denominado inspectors en la clase ThisAddIn.El campo inspectors mantiene una referencia a la colección de ventanas de inspector en la instancia de Outlook actual.Esta referencia evita que el recolector de elementos no utilizados libere la memoria que contiene el controlador de eventos para el evento NewInspector.
```
Private WithEvents inspectors As Outlook.Inspectors
```
```
Outlook.Inspectors inspectors;
```

Reemplace el método ThisAddIn_Startup por el código siguiente.Este código asocia un controlador de eventos al evento NewInspector.

Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    inspectors = Me.Application.Inspectors
End Sub

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    inspectors = this.Application.Inspectors;
    inspectors.NewInspector +=
    new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
}

En el archivo de código ThisAddIn, agregue el código siguiente a la clase ThisAddIn.Este código define un controlador de eventos para el evento NewInspector.

Cuando el usuario crea un mensaje de correo nuevo, este controlador de eventos agrega texto a la línea de asunto y al cuerpo del mensaje.

Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
    Dim mailItem As Outlook.MailItem = TryCast(Inspector.CurrentItem, Outlook.MailItem)
    If Not (mailItem Is Nothing) Then
        If mailItem.EntryID Is Nothing Then
            mailItem.Subject = "This text was added by using code"
            mailItem.Body = "This text was added by using code"
        End If
    End If
End Sub

void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
{
    Outlook.MailItem mailItem = Inspector.CurrentItem as Outlook.MailItem;
    if (mailItem != null)
    {
        if (mailItem.EntryID == null)
        {
            mailItem.Subject = "This text was added by using code";
            mailItem.Body = "This text was added by using code";
        }

    }
}

Para modificar cada mensaje de correo nuevo, los ejemplos de código anteriores utilizan los objetos siguientes:

El campo Application de la clase ThisAddIn.El campo Application devuelve un objeto Application, que representa la instancia actual de Outlook.
El parámetro Inspector del controlador del evento NewInspector.El parámetro Inspector es un objeto Inspector, que representa la ventana de inspector del nuevo mensaje de correo.Para obtener más información, vea Soluciones de Outlook.

Probar el proyecto

Al compilar y ejecutar el proyecto, compruebe que aparece texto en la línea de asunto y en el cuerpo de un nuevo mensaje de correo.

Para probar el proyecto

Presione F5 para compilar y ejecutar el proyecto.

Al generar el proyecto, el código se genera en un ensamblado que se incluye en la carpeta de resultado de compilación del proyecto.Visual Studio también crea un conjunto de entradas del Registro que permiten que Outlook detecte y cargue el complemento, y establece la configuración de seguridad en el equipo de desarrollo a fin de permitir la ejecución del complemento.Para obtener más información, vea Tutorial: Crear el primer complemento en el nivel de la aplicación para Outlook.
En Outlook, cree un mensaje nuevo de correo electrónico.
Compruebe que el texto siguiente se agrega a la línea de asunto y al cuerpo del mensaje.

Este texto se agregó mediante código.
Cierre Outlook.

Limpiar el proyecto

Al terminar de desarrollar un proyecto, quite el ensamblado de complemento, las entradas del Registro y la configuración de seguridad del equipo de desarrollo.De lo contrario, el complemento se ejecutará cada vez que abra Outlook en el equipo de desarrollo.

Para limpiar el proyecto

En el menú Compilar de Visual Studio, haga clic en Limpiar solución.

Pasos siguientes

Ahora que ha creado un complemento básico en el nivel de la aplicación para Outlook, puede obtener más información sobre la programación de complementos en estos temas:

Tareas de programación generales que puede hacer usando los complementos para Outlook.Para obtener más información, vea Programar complementos de nivel de aplicación.
Utilizar el modelo de objetos de Outlook.Para obtener más información, vea Soluciones de Outlook.
Personalizar la interfaz de usuario de Outlook, por ejemplo, agregando una ficha personalizada a la cinta de opciones o creando un panel de tareas personalizado.Para obtener más información, vea Personalización de la interfaz de usuario de Office.
Compilar y depurar los complementos en el nivel de la aplicación para Outlook.Para obtener más información, vea Compilar soluciones de Office.
Implementar complementos en el nivel de la aplicación para Outlook.Para obtener más información, vea Implementar una solución de Office.