Udostępnij za pośrednictwem

Przewodnik: tworzenie pierwszego dodatku VSTO dla projektu

  • Artykuł

W tym przewodniku pokazano, jak utworzyć dodatek VSTO dla programu Microsoft Office Project. Funkcje tworzone w tym rodzaju rozwiązania są dostępne dla samej aplikacji, niezależnie od tego, które projekty są otwarte. Aby uzyskać więcej informacji, zobacz Omówienie programowania rozwiązań pakietu Office (VSTO).

Dotyczy: informacje w tym temacie dotyczą projektów dodatków VSTO dla programu Project. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

W instruktażu przedstawiono następujące zagadnienia:

  • Tworzenie projektu dodatku VSTO projektu.

  • Pisanie kodu korzystającego z modelu obiektów programu Project w celu dodania zadania do nowego projektu.

  • Kompilowanie i uruchamianie projektu w celu jego przetestowania.

  • Czyszczenie ukończonego projektu w taki sposób, aby dodatek VSTO nie był już uruchamiany automatycznie na komputerze dewelopera.

    Uwaga

    Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE.

Wymagania wstępne

Następujące składniki są wymagane do przeprowadzenia tego instruktażu:

Tworzenie projektu

Aby utworzyć nowy projekt w programie Visual Studio

  1. Uruchom program Visual Studio.

  2. W menu Plik wskaż polecenie Nowy, a następnie kliknij pozycję Projekt.

  3. W okienku szablonów rozwiń węzeł Visual C# lub Visual Basic, a następnie rozwiń węzeł Office/SharePoint.

  4. W rozwiniętym węźle Office/SharePoint wybierz węzeł Dodatki pakietu Office.

  5. Na liście szablonów projektów wybierz pozycję Dodatek programu Project 2010 lub Dodatek programu Project 2013.

  6. W polu Nazwa wpisz FirstProjectAddIn.

  7. Kliknij przycisk OK.

    Program Visual Studio tworzy projekt FirstProjectAddIn i otwiera plik kodu ThisAddIn w edytorze.

Pisanie kodu, który dodaje nowe zadanie do projektu

Następnie dodaj kod do pliku kodu ThisAddIn. Nowy kod używa modelu obiektów projektu, aby dodać nowe zadanie do projektu. Domyślnie plik kodu ThisAddIn zawiera następujący wygenerowany kod:

  • Częściowa definicja ThisAddIn klasy. Ta klasa zapewnia punkt wejścia dla kodu i zapewnia dostęp do modelu obiektów programu Project. Aby uzyskać więcej informacji, zobacz Program VSTO Add-ins (Dodatki programu VSTO). Pozostała część ThisAddIn klasy jest zdefiniowana w ukrytym pliku kodu, którego nie należy modyfikować.

  • Programy obsługi zdarzeń ThisAddIn_Startup i ThisAddIn_Shutdown . Te programy obsługi zdarzeń są wywoływane, gdy program Project ładuje i zwalnia dodatek VSTO. Użyj tych procedur obsługi zdarzeń, aby zainicjować dodatek VSTO podczas ładowania i wyczyścić zasoby używane przez dodatek VSTO podczas jego zwolnienia. Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Aby dodać zadanie do nowego projektu

  1. W pliku kodu ThisAddIn dodaj następujący kod do ThisAddIn klasy . Ten kod definiuje procedurę obsługi zdarzeń dla NewProject zdarzenia Microsoft.Office.Interop.MSProject.Application klasy.

    Gdy użytkownik utworzy nowy projekt, ten program obsługi zdarzeń dodaje zadanie do projektu.

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

    Aby zmodyfikować projekt, w tym przykładzie kodu są używane następujące obiekty:

  • Pole Application ThisAddIn klasy . Pole Application zwraca Microsoft.Office.Interop.MSProject.Application obiekt, który reprezentuje bieżące wystąpienie programu Project.

  • pj Parametr programu obsługi zdarzeń dla zdarzenia NewProject. Parametr pj jest obiektem reprezentującym Microsoft.Office.Interop.MSProject.Project projekt. Aby uzyskać więcej informacji, zobacz Project solutions (Rozwiązania projektu).

  1. Jeśli używasz języka C#, dodaj następujący kod do procedury obsługi zdarzeń ThisAddIn_Startup . Ten kod łączy Application_Newproject program obsługi zdarzeń ze zdarzeniem NewProject.

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

Testowanie projektu

Podczas kompilowanie i uruchamianie projektu sprawdź, czy nowe zadanie pojawia się w wynikowym nowym projekcie.

Aby przetestować projekt

  1. Naciśnij klawisz F5 , aby skompilować i uruchomić projekt. Program Microsoft Project uruchamia i automatycznie otwiera nowy pusty projekt.

    Podczas kompilowania projektu kod jest kompilowany w zestawie, który znajduje się w folderze danych wyjściowych kompilacji dla projektu. Program Visual Studio tworzy również zestaw wpisów rejestru, które umożliwiają programowi Project odnajdywanie i ładowanie dodatku VSTO oraz konfigurowanie ustawień zabezpieczeń na komputerze dewelopera w celu włączenia uruchamiania dodatku VSTO. Aby uzyskać więcej informacji, zobacz Omówienie procesu kompilacji rozwiązania pakietu Office.

  2. Sprawdź, czy nowe zadanie zostało dodane do pustego projektu.

  3. Sprawdź, czy w polu Nazwa zadania pojawi się następujący tekst.

    Ten tekst został dodany przy użyciu kodu.

  4. Zamknij program Microsoft Project.

Czyszczenie projektu

Po zakończeniu tworzenia projektu usuń zestaw dodatku VSTO, wpisy rejestru i ustawienia zabezpieczeń z komputera dewelopera. W przeciwnym razie dodatek VSTO będzie uruchamiany za każdym razem, gdy otworzysz program Microsoft Project na komputerze dewelopera.

Aby wyczyścić projekt

  1. W programie Visual Studio w menu Kompilacja kliknij pozycję Wyczyść rozwiązanie.

Następne kroki

Po utworzeniu podstawowego dodatku VSTO dla programu Project możesz dowiedzieć się więcej o sposobie tworzenia dodatków VSTO z następujących tematów:

Powiązana zawartość