Condividi tramite


Procedura dettagliata: Creare il primo componente aggiuntivo VSTO per Outlook

Questa procedura dettagliata illustra come creare un componente aggiuntivo VSTO per Microsoft Office Outlook. Le funzionalità create in questo tipo di soluzione sono disponibili per l'applicazione indipendentemente dagli elementi Outlook aperti. Per altre informazioni, vedere Panoramica dello sviluppo di soluzioni Office (VSTO).

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti di componente aggiuntivo VSTO per Outlook. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Nota

Si è interessati allo sviluppo di soluzioni che estendono l'esperienza di Office tra più piattaforme? Vedere il nuovo modello di componenti aggiuntivi per Office. I componenti aggiuntivi di Office hanno un footprint ridotto rispetto ai componenti aggiuntivi e alle soluzioni VSTO ed è possibile compilarli usando quasi qualsiasi tecnologia di programmazione Web, ad esempio HTML5, JavaScript, CSS3 e XML.

In questa procedura dettagliata sono illustrati i task seguenti:

  • Creazione di un progetto di componente aggiuntivo VSTO per Outlook.

  • Scrittura del codice che usa il modello a oggetti di Outlook per aggiungere testo all'oggetto e al corpo di un nuovo messaggio di posta elettronica.

  • Creazione ed esecuzione del progetto a scopo di test.

  • Pulizia del progetto completato, per fare in modo che il componente aggiuntivo VSTO non venga più eseguito automaticamente nel computer di sviluppo.

    Nota

    I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzare l'IDE.

Prerequisiti

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

Creare il progetto

Per creare un nuovo progetto Outlook in Visual Studio

  1. Avviare Visual Studio.

  2. Scegliere Nuovo dal menu Filee quindi fare clic su Progetto.

  3. Nel riquadro dei modelli, espandere Visual C# o Visual Basic, quindi espandere Office/SharePoint.

  4. Nel nodo Office/SharePoint espanso, selezionare il nodo Componenti aggiuntivi di Office .

  5. Nell'elenco dei modelli di progetto scegliere un progetto di componente aggiuntivo VSTO di Outlook.

  6. Nella casella Nome , digitare FirstOutlookAddIn.

  7. Fare clic su OK.

    Visual Studio crea il progetto FirstOutlookAddIn e apre il file di codice ThisAddIn nell'editor.

Scrivere codice che aggiunge testo a ogni nuovo messaggio di posta elettronica

Aggiungere quindi codice al file di codice ThisAddIn. Il nuovo codice usa il modello a oggetti di Outlook per aggiungere il testo a ciascun nuovo messaggio di posta elettronica. Per impostazione predefinita, il file di codice ThisAddIn contiene il seguente codice generato:

  • Una definizione parziale della classe ThisAddIn . Questa classe fornisce un punto di ingresso per il codice e fornisce l'accesso al modello a oggetti di Outlook. Per altre informazioni, vedere Programmare componenti aggiuntivi VSTO. Il resto della ThisAddIn classe è definito in un file di codice nascosto che non è consigliabile modificare.

  • I gestori eventi ThisAddIn_Startup e ThisAddIn_Shutdown . Questi gestori eventi vengono chiamati quando Outlook carica e scarica il componente aggiuntivo VSTO. Usare questi gestori eventi per inizializzare il componente aggiuntivo VSTO al momento del caricamento e per eseguire la pulizia delle risorse usate dal componente aggiuntivo VSTO quando viene scaricato. Per altre informazioni, vedere Eventi nei progetti di Office.

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

  1. Nel file di codice ThisAddIn, dichiarare un campo denominato inspectors nella classe ThisAddIn . Il campo inspectors gestisce un riferimento alla raccolta 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 .

    Outlook.Inspectors inspectors;
    
  2. Sostituire il metodo ThisAddIn_Startup con il codice seguente. Questo codice consente di collegare un gestore eventi all'evento NewInspector .

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
    {
        inspectors = this.Application.Inspectors;
        inspectors.NewInspector +=
        new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
    }
    
  3. 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.

    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";
            }
    
        }
    }
    

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

  • Il campo Application della classe ThisAddIn . Il campo Application restituisce un oggetto Application che rappresenta l'istanza corrente di Outlook.

  • Il parametro Inspector del gestore eventi dell'evento NewInspector . Il parametro Inspector è un oggetto Inspector che rappresenta la finestra di controllo del nuovo messaggio di posta elettronica. Per altre informazioni, vedere Soluzioni outlook.

Testare il 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 testare il progetto

  1. Premere F5 per compilare ed eseguire il progetto.

    Quando si crea il progetto, il codice viene compilato in un assembly incluso nella cartella di output di compilazione relativa al progetto. Visual Studio crea anche un set di voci del Registro di sistema che consentono a Outlook di trovare e caricare il componente aggiuntivo VSTO e di configurare le impostazioni di sicurezza nel computer di sviluppo; in questo modo, si attiva l'esecuzione del componente aggiuntivo VSTO. Per altre informazioni, vedere Panoramica del processo di compilazione della soluzione Office.

  2. In Outlook, creare un nuovo messaggio di posta elettronica.

  3. Verificare che il testo seguente venga aggiunto sia alla riga dell'oggetto, sia al corpo del messaggio.

    This text was added by using code.

  4. Chiudi Outlook.

Pulire il progetto

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

Per pulire il progetto

  1. In Visual Studio, nel menu Compila , fare clic su Pulisci soluzione.

Passaggi successivi

Ora che è stato creato un componente aggiuntivo VSTO di base per Outlook, è possibile visualizzare altre informazioni sullo sviluppo di componenti aggiuntivi VSTO in questi argomenti:

  • Attività di programmazione generali che è possibile eseguire usando i componenti aggiuntivi VSTO per Outlook. Per altre informazioni, vedere Programmare componenti aggiuntivi VSTO.

  • Uso del modello a oggetti di Outlook. Per altre informazioni, vedere Soluzioni outlook.

  • Personalizzazione dell'interfaccia utente di Outlook, ad esempio con l'aggiunta di una scheda personalizzata alla barra multifunzione o la creazione di un riquadro attività personalizzato. Per altre informazioni, vedere Personalizzazione dell'interfaccia utente di Office.

  • Compilazione e debug di componenti aggiuntivi VSTO per Outlook. Per altre informazioni, vedere Creare soluzioni Office.

  • Distribuzione di componenti aggiuntivi VSTO per Outlook. Per altre informazioni, vedere Distribuire una soluzione Office.