Procedura dettagliata: Creare il primo componente aggiuntivo VSTO per Project

  • Articolo

Questa procedura dettagliata illustra come creare un componente aggiuntivo VSTO per Microsoft Office Project. Le funzionalità create in questo tipo di soluzione sono disponibili per l'applicazione, indipendentemente dai progetti 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 Project. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

In questa procedura dettagliata sono illustrati i task seguenti:

  • Creazione di un progetto di componente aggiuntivo VSTO di Project.

  • Scrittura di codice che usa il modello a oggetti di Project per aggiungere un'attività a un nuovo progetto.

  • 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 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 selezionare Componente aggiuntivo per Project 2010 o Componente aggiuntivo per Project 2013.

  6. Nella casella Nome digitare FirstProjectAddIn.

  7. Fare clic su OK.

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

Scrivere codice che aggiunge una nuova attività a un progetto

Aggiungere quindi codice al file di codice ThisAddIn. Il nuovo codice usa il modello a oggetti di Project per aggiungere una nuova attività a un progetto. 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 consente di accedere al modello a oggetti di Project. 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 Project 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 un'attività a un nuovo progetto

  1. Nel file di codice ThisAddIn, aggiungere il codice seguente alla classe ThisAddIn . Questo codice definisce un gestore eventi per l'evento NewProject della classe Microsoft.Office.Interop.MSProject.Application.

    Quando l'utente crea un nuovo progetto, questo gestore eventi aggiunge un'attività al progetto.

    void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj)
{
    MSProject.Task newTask = pj.Tasks.Add
        ("This text was added by using code", missing);
    newTask.Start = DateTime.Now;
    newTask.Duration = "3";
    newTask.ResourceNames = "Rob Caron, Kelly Krout";
}

    Per modificare il progetto, questo esempio di codice usa gli oggetti seguenti:

  • Il campo Application della classe ThisAddIn . Il Application campo restituisce un Microsoft.Office.Interop.MSProject.Application oggetto che rappresenta l'istanza corrente di Project.

  • Parametro pj del gestore eventi per l'evento NewProject. Il parametro pj è un oggetto Microsoft.Office.Interop.MSProject.Project che rappresenta il progetto. Per altre informazioni, vedere Soluzioni di project.

  1. Se si usa C#, aggiungere il seguente codice al gestore eventi ThisAddIn_Startup . Questo codice connette il Application_Newproject gestore eventi con l'evento NewProject.

    this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);

Testare il progetto

Quando si compila e si esegue il progetto, verificare che la nuova attività venga visualizzata nel progetto risultante.

Per testare il progetto

  1. Premere F5 per compilare ed eseguire il progetto. Microsoft Project viene avviato e viene aperto automaticamente un nuovo progetto vuoto.

    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 permettono a Project di individuare e caricare il componente aggiuntivo VSTO e configura le impostazioni di sicurezza nel computer di sviluppo per consentire l'esecuzione del componente aggiuntivo VSTO. Per altre informazioni, vedere Panoramica del processo di compilazione della soluzione Office.

  2. Verificare che nel progetto vuoto sia stata aggiunta una nuova attività.

  3. Verificare che nel campo Task Name dell'attività sia visualizzato il testo seguente.

    This text was added by using code.

  4. Chiudere Microsoft Project.

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 Microsoft Project nel computer di sviluppo.

Per pulire il progetto

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

Passaggi successivi

Dopo aver creato un componente aggiuntivo VSTO di base per Project, vedere gli argomenti seguenti per altre informazioni su come sviluppare componenti aggiuntivi VSTO:

Contenuto correlato