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

Articolo
08/11/2011

In questa procedura dettagliata viene illustrato come creare un componente aggiuntivo a livello di applicazione per Microsoft Office Project. Le funzionalità create in questo tipo di soluzione sono disponibili per l'applicazione indipendentemente da quali progetti vengano 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 Project 2007 e Project 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 Project.
Scrittura di codice che utilizza il modello a oggetti di Project per aggiungere un'attività a un nuovo progetto.
Compilazione ed esecuzione del progetto a scopo di verifica.
Pulitura del progetto completato affinché 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 Project 2007 o Project 2010.

Creazione del progetto

Per creare un nuovo progetto 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 Project 2007 o selezionare il nodo 2010 se è installato Project 2010.
Nell'elenco dei modelli selezionare Componente aggiuntivo per Project 2007 o Componente aggiuntivo per Project 2010.
Nella casella Nome digitare FirstProjectAddIn.
Scegliere OK.

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

Scrittura di codice per aggiungere una nuova attività a un progetto

Successivamente, aggiungere codice al file di codice ThisAddIn. Il nuovo codice utilizza il modello a oggetti di Project per aggiungere una nuova attività a un progetto. 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 Project. 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 Project. 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 un'attività a un nuovo progetto

Nel file di codice ThisAddIn, aggiungere il codice seguente alla classe ThisAddIn. Questo codice consente di definire 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à a quest'ultimo.

Private Sub Application_NewProject(ByVal pj As Microsoft.Office.Interop.MSProject.Project) Handles Application.NewProject
    Dim newTask As MSProject.Task
    newTask = pj.Tasks.Add _
    ("This text was added by using code")
    newTask.Start = DateTime.Now
    newTask.Duration = "3"
    newTask.ResourceNames = "Rob Caron, Kelly Krout"
End Sub

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, in questo esempio di codice si utilizzano gli oggetti seguenti:

Campo Application della classe ThisAddIn. Il campo Application restituisce un oggetto Microsoft.Office.Interop.MSProject.Application 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 ulteriori informazioni, vedere Soluzioni Project.

Se si utilizza C#, aggiungere il codice riportato di seguito al gestore eventi ThisAddIn_Startup. Questo codice connette il gestore eventi Application_Newproject all'evento NewProject.
```
this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);
```

Verifica del progetto

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

Per verificare il progetto

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

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 Project 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.
Verificare che al progetto vuoto venga aggiunta una nuova attività.
Verificare che nel campo Nome attività dell'attività venga visualizzato il testo seguente.

Questo testo è stato aggiunto tramite codice.
Chiudere Microsoft Project.

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 Microsoft Project 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 Project, per acquisire ulteriori informazioni sullo sviluppo di componenti aggiuntivi è possibile consultare gli argomenti seguenti:

Attività di programmazione generali eseguibili nei componenti aggiuntivi per Project: Programmazione di componenti aggiuntivi a livello di applicazione.
Utilizzo del modello a oggetti di Project: Soluzioni Project.
Compilazione e debug di componenti aggiuntivi a livello di applicazione per Project: Compilazione e debug delle soluzioni Office.
Distribuzione di componenti aggiuntivi a livello di applicazione per Project: Distribuzione di soluzioni Office.