Dela via

Genomgång: Skapa ditt första VSTO-tillägg för Project

Den här genomgången visar hur du skapar ett VSTO-tillägg för Microsoft Office Project. De funktioner som du skapar i den här typen av lösning är tillgängliga för själva programmet, oavsett vilka projekt som är öppna. Mer information finns i Översikt över utveckling av Office-lösningar (VSTO).

Gäller för: Informationen i det här avsnittet gäller för VSTO-tilläggsprojekt för Project. Mer information finns i Funktioner som är tillgängliga efter Office-program och projekttyp.

I den här genomgången tas följande aktiviteter upp:

  • Skapa ett PROJECT VSTO-tilläggsprojekt.

  • Skriva kod som använder objektmodellen i Project för att lägga till en uppgift i ett nytt projekt.

  • Skapa och köra projektet för att testa det.

  • Rensa det slutförda projektet så att VSTO-tillägget inte längre körs automatiskt på utvecklingsdatorn.

    Anmärkning

    Datorn kan visa olika namn eller platser för vissa av Visual Studio-användargränssnittselementen i följande instruktioner. Den Visual Studio-utgåva som du har och de inställningar som du använder avgör dessa element. Mer information finns i Anpassa IDE.

Förutsättningar

Du behöver följande komponenter för att slutföra den här genomgången:

Skapa projektet

Skapa ett nytt projekt i Visual Studio

  1. Starta Visual Studio.

  2. Peka på Nytt på Arkiv-menyn och klicka sedan på Projekt.

  3. I fönstret Mallar expanderar du Visual C# eller Visual Basic och expanderar sedan Office/SharePoint.

  4. Under den expanderade Noden Office/SharePoint väljer du noden Office-tillägg .

  5. I listan över projektmallar väljer du Project 2010-tillägg eller Project 2013-tillägg.

  6. I rutan Namn skriver du FirstProjectAddIn.

  7. Klicka på OK.

    Visual Studio skapar Projektet FirstProjectAddIn och öppnar kodfilen ThisAddIn i redigeraren.

Skriva kod som lägger till en ny aktivitet i ett projekt

Lägg sedan till kod i kodfilen ThisAddIn. Den nya koden använder objektmodellen i Project för att lägga till en ny aktivitet i ett projekt. Kodfilen ThisAddIn innehåller som standard följande genererade kod:

  • En partiell definition av ThisAddIn klassen. Den här klassen tillhandahåller en startpunkt för koden och ger åtkomst till objektmodellen i Project. Mer information finns i Program VSTO-tillägg. Resten av ThisAddIn klassen definieras i en dold kodfil som du inte bör ändra.

  • Händelsehanterarna ThisAddIn_Startup och ThisAddIn_Shutdown . Dessa händelsehanterare anropas när Project läser in och tar bort ditt VSTO-tillägg. Använd dessa händelsehanterare för att initiera DITT VSTO-tillägg när det läses in och för att rensa resurser som används av VSTO-tillägget när det tas bort. Mer information finns i Händelser i Office-projekt.

Så här lägger du till en aktivitet i ett nytt projekt

  1. I kodfilen ThisAddIn lägger du till följande kod i ThisAddIn klassen. Den här koden definierar en händelsehanterare för NewProject händelsen för Microsoft.Office.Interop.MSProject.Application klassen.

    När användaren skapar ett nytt projekt lägger den här händelsehanteraren till en aktivitet i projektet.

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

    För att ändra projektet använder det här kodexemplet följande objekt:

  • Fältet Application för ThisAddIn klassen. Fältet Application returnerar ett Microsoft.Office.Interop.MSProject.Application objekt som representerar den aktuella instansen av Project.

  • Parametern pj för händelsehanteraren för newproject-händelsen. Parametern pj är ett Microsoft.Office.Interop.MSProject.Project objekt som representerar projektet. Mer information finns i Projektlösningar.

  1. Om du använder C# lägger du till följande kod i ThisAddIn_Startup händelsehanteraren. Den här koden ansluter Application_Newproject händelsehanteraren till newproject-händelsen.

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

Testa projektet

När du skapar och kör projektet kontrollerar du att den nya aktiviteten visas i det resulterande nya projektet.

Så här testar du projektet

  1. Tryck på F5 för att skapa och köra projektet. Microsoft Project startar och öppnar automatiskt ett nytt tomt projekt.

    När du skapar projektet kompileras koden till en sammansättning som ingår i utdatamappen för projektet. Visual Studio skapar också en uppsättning registerposter som gör det möjligt för Project att identifiera och läsa in VSTO-tillägget, och konfigurerar säkerhetsinställningarna på utvecklingsdatorn så att VSTO-tillägget kan köras. Mer information finns i Översikt över byggprocessen för Office-lösningar.

  2. Kontrollera att en ny aktivitet har lagts till i det tomma projektet.

  3. Kontrollera att följande text visas i fältet Aktivitetsnamn i aktiviteten.

    Den här texten har lagts till med hjälp av kod.

  4. Stäng Microsoft Project.

Rensa projektet

När du har utvecklat ett projekt tar du bort VSTO-tilläggssammansättningen, registerposterna och säkerhetsinställningarna från utvecklingsdatorn. Annars körs VSTO-tillägget varje gång du öppnar Microsoft Project på utvecklingsdatorn.

Så här rensar du projektet

  1. I Visual Studio går du till menyn Skapa och klickar på Rensa lösning.

Nästa steg

Nu när du har skapat ett grundläggande VSTO-tillägg för Project kan du lära dig mer om hur du utvecklar VSTO-tillägg från följande ämnen:

Relaterat innehåll