Procedura dettagliata: creazione di un componente aggiuntivo a livello di applicazione per Outlook

Articolo
08/11/2011

In questa procedura dettagliata viene illustrato come creare un componente aggiuntivo a livello di applicazione per Microsoft Office Outlook. Le funzionalità create in questo tipo di soluzione sono disponibili per l'applicazione indipendentemente dagli elementi Outlook aperti. Per ulteriori informazioni, vedere Cenni preliminari sullo sviluppo di soluzioni Office.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di applicazione per Outlook 2007 e Outlook 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

In questa procedura dettagliata vengono illustrate le seguenti attività:

Creazione di un progetto componente aggiuntivo per Outlook.
Scrittura del codice che utilizza il modello a oggetti di Outlook per aggiungere testo all'oggetto e al corpo di un nuovo messaggio di posta elettronica.
Compilazione ed esecuzione del progetto a scopo di verifica.
Pulitura del progetto completato in modo che il componente aggiuntivo non venga più eseguito automaticamente nel computer di sviluppo.

Nota

Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Prerequisiti

Per completare la procedura dettagliata, è necessario disporre dei componenti seguenti:

Una versione di Visual Studio 2010 che include gli strumenti per sviluppatori di Microsoft Office. Per ulteriori informazioni, vedere [Configurazione di un computer per sviluppare soluzioni Office](bb398242\(v=vs.100\).md).

Microsoft Office Outlook 2007 o Outlook 2010.

Creazione del progetto

Per creare un nuovo progetto Outlook in Visual Studio

Avviare Visual Studio.
Scegliere Nuovo dal menu File, quindi fare clic su Progetto.
Nel riquadro dei modelli espandere Visual C# o Visual Basic, quindi espandere Office.
In corrispondenza del nodo Office espanso, selezionare 2007 se è installato Outlook 2007 oppure il nodo 2010 se è installato Outlook 2010.
Nell'elenco dei modelli di progetto selezionare Componente aggiuntivo per Outlook 2007 o Componente aggiuntivo per Outlook 2010.
Nella casella Nome, digitare FirstOutlookAddIn.
Scegliere OK.

Visual Studio consente di creare il progetto FirstOutlookAddIn e di aprire il file di codice ThisAddIn nell'editor.

Scrittura del codice che aggiunge testo a ogni nuovo messaggio di posta elettronica

Successivamente, aggiungere codice al file di codice ThisAddIn. Il nuovo codice utilizza il modello a oggetti di Outlook per aggiungere il testo a ciascun nuovo messaggio di posta elettronica. Per impostazione predefinita, nel file di codice ThisAddIn è contenuto il seguente codice generato:

Definizione parziale della classe ThisAddIn. Questa classe fornisce un punto di ingresso per il codice e consente di accedere al modello a oggetti di Outlook. Per ulteriori informazioni, vedere Programmazione di componenti aggiuntivi a livello di applicazione. Il resto della classe ThisAddIn è definito in un file di codice nascosto che non deve essere modificato.
Gestori eventi ThisAddIn_Startup e ThisAddIn_Shutdown. Questi gestori eventi vengono chiamati quando il componente aggiuntivo viene caricato e scaricato da Outlook. Possono essere utilizzati per inizializzare il componente aggiuntivo quando viene caricato e per liberare le risorse utilizzate dal componente aggiuntivo quando viene scaricato. Per ulteriori informazioni, vedere Eventi nei progetti di Office.

Per aggiungere testo all'oggetto e al corpo di ciascun nuovo messaggio di posta elettronica

Nel file di codice ThisAddIn, dichiarare un campo denominato inspectors nella classe ThisAddIn. Il campo inspectors gestisce un riferimento all'insieme di finestre di controllo nell'istanza Outlook corrente. Questo riferimento impedisce al Garbage Collector di liberare la memoria in cui è contenuto il gestore eventi per l'evento NewInspector.
```
Private WithEvents inspectors As Outlook.Inspectors
```
```
Outlook.Inspectors inspectors;
```

Sostituire il metodo ThisAddIn_Startup con il codice seguente. Questo codice consente di collegare un gestore eventi all'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);
}

Nel file di codice ThisAddIn, aggiungere il codice seguente alla classe ThisAddIn. Questo codice consente di definire un gestore eventi per l'evento NewInspector.

Quando l'utente crea un nuovo messaggio di posta elettronica, questo gestore eventi consente di aggiungere il testo alla riga dell'oggetto e al corpo del messaggio.

Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
    Dim mailItem As Outlook.MailItem = CType(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 = (Outlook.MailItem)Inspector.CurrentItem;
    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";
        }

    }
}

Per modificare ciascun nuovo messaggio di posta elettronica, negli esempi di codice precedenti vengono utilizzati gli oggetti seguenti:

Campo Application della classe ThisAddIn. Il campo Application restituisce un oggetto Application che rappresenta l'istanza corrente di Outlook.
Parametro Inspector del gestore eventi per l'evento NewInspector. Il parametro Inspector è un oggetto Inspector che rappresenta la finestra di controllo del nuovo messaggio di posta elettronica. Per ulteriori informazioni, vedere Soluzioni Outlook.

Verifica del progetto

Quando il progetto viene compilato ed eseguito, verificare che il testo venga visualizzato nella riga dell'oggetto e nel corpo di un nuovo messaggio di posta elettronica.

Per verificare il progetto

Premere F5 per compilare ed eseguire il progetto.

Quando si compila il progetto, il codice viene compilato in un assembly che viene incluso nella cartella di output di compilazione del progetto. Visual Studio permette inoltre di creare un insieme di voci del Registro di sistema che consente a Outlook di individuare e caricare il componente aggiuntivo e di configurare le impostazioni di sicurezza nel computer di sviluppo in modo da consentire l'esecuzione del componente aggiuntivo. Per ulteriori informazioni, vedere Cenni preliminari sul processo di compilazione delle soluzioni Office.
In Outlook, creare un nuovo messaggio di posta elettronica.
Verificare che il testo seguente venga aggiunto sia alla riga dell'oggetto, sia al corpo del messaggio.

Questo testo è stato aggiunto tramite codice.
Chiudere Outlook.

Pulitura del progetto

Quando si completa lo sviluppo di un progetto, rimuovere dal computer di sviluppo l'assembly del componente aggiuntivo, le voci del Registro di sistema e le impostazioni di sicurezza. In caso contrario, il componente aggiuntivo verrà eseguito ogni volta che si apre Outlook nel computer di sviluppo.

Per pulire il progetto

In Visual Studio, nel menu Compila, scegliere Pulisci soluzione.

Passaggi successivi

Una volta creato un componente aggiuntivo di base a livello di applicazione per Outlook, per acquisire ulteriori informazioni sullo sviluppo di componenti aggiuntivi è possibile consultare gli argomenti seguenti:

Attività di programmazione generali eseguibili utilizzando i componenti aggiuntivi per Outlook. Per ulteriori informazioni, vedere Programmazione di componenti aggiuntivi a livello di applicazione.
Utilizzo del modello a oggetti di Outlook. Per ulteriori informazioni, vedere Soluzioni Outlook.
Personalizzazione dell'interfaccia utente di Outlook, ad esempio tramite l'aggiunta di una scheda personalizzata alla barra multifunzione o la creazione di un riquadro attività personalizzato. Per ulteriori informazioni, vedere Personalizzazione dell'interfaccia utente di Office.
Compilazione e debug di componenti aggiuntivi a livello di applicazione per Outlook. Per ulteriori informazioni, vedere Compilazione e debug delle soluzioni Office.
Distribuzione di componenti aggiuntivi a livello di applicazione per Outlook. Per ulteriori informazioni, vedere Distribuzione di soluzioni Office.