Wskazówki: tworzenie pierwszego dodatku na poziomie aplikacji dla projektu

Artykuł
06/10/2015

W tym instruktażu przedstawiono sposób stworzyć poziom aplikacji dodatek dla programu Microsoft Office Project.Funkcje, które można tworzyć w tego rodzaju rozwiązanie są dostępne dla samej aplikacji, niezależnie od tego, które projekty są otwarte.Aby uzyskać więcej informacji, zobacz Rozwój rozwiązań Office ― Omówienie.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie aplikacji obsługiwanych w programach Project 2013 i Project 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

W tym instruktażu przedstawiono następujące zadania:

Tworzenie projektu-w projekcie.
Pisanie kodu, który używa modelu projektu, aby dodać zadanie do nowego projektu.
Tworzenie i uruchamianie projektu, aby go przetestować.
Oczyszczanie zakończonych projektów tak, że dodatek nie działa 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 Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Wymagania wstępne

Potrzebne do przeprowadzenia tego instruktażu następujące składniki:

Edycja programu Visual Studio 2013, która oferuje narzędzia deweloperskie pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz Konfigurowanie komputera do opracowywania rozwiązań pakietu Office.
Project 2013or Project 2010.

Tworzenie projektu

Aby utworzyć nowy projekt w programie Visual Studio

Start Visual Studio.
Na pliku menu, wskaż Nowa, a następnie kliknij przycisk Projekt.
W okienku szablony, rozwiń węzeł Visual C# lub programu Visual Basic, a następnie rozwiń węzeł Office i SharePoint.
W obszarze rozszerzony Office i SharePoint węzła, zaznacz Dodatki pakietu Office węzła.
Zaznacz na liście szablonów projektu, Project 2010 Add-in lub dodatek 2013 projektu.
W Nazwa wpisz FirstProjectAddIn.
Kliknij przycisk OK.

Visual StudioTworzy FirstProjectAddIn projekt i otwiera ThisAddIn pliku kodu w edytorze.

Pisanie kodu, który dodaje nowe zadanie do projektu

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

Częściowe definicja ThisAddIn klasy.Ta klasa zapewnia punktu wejścia dla kodu i zapewnia dostęp do modelu obiektu programu Project.Aby uzyskać więcej informacji, zobacz Programowanie dodatków na poziomie aplikacji.Pozostałą część ThisAddIn klasa jest zdefiniowana w pliku ukrytego kodu, który nie należy modyfikować.
ThisAddIn_Startup i ThisAddIn_Shutdown obsługi zdarzeń.Te programy obsługi zdarzeń są wywoływane, gdy projekt ładuje i wyładowuje dodatku.Zainicjowanie dodatku po załadowaniu i oczyścić zasoby używane przez dodatku, gdy jest zwalniany, należy użyć te programy obsługi zdarzeń.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Aby dodać zadanie do nowego projektu

W pliku ThisAddIn kodu, Dodaj następujący kod do ThisAddIn klasy.Ten kod definiuje obsługi zdarzenia NewProject przypadku Microsoft.Office.Interop.MSProject.Application klasy.

Gdy użytkownik tworzy nowy projekt, ten program dodaje zadania do projektu.

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

Do modyfikowania projektu, w tym przykładzie kodu używać następujących obiektów:

Application Pole ThisAddIn klasy.Application Zwraca wartość w polu Microsoft.Office.Interop.MSProject.Application obiekt, który reprezentuje wystąpienie bieżącego projektu.
pj Parametr programu obsługi zdarzeń dla NewProject zdarzenie.pj Parametr jest Microsoft.Office.Interop.MSProject.Project obiekt, który reprezentuje projektu.Aby uzyskać więcej informacji, zobacz Rozwiązania projektu.

Jeśli używasz języka C#, Dodaj następujący kod do ThisAddIn_Startup programu obsługi zdarzeń.Łączy ten kod Application_Newproject obsługi zdarzeń z NewProject zdarzenie.
```
this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);
```

Testowanie projektu

Gdy skompilować i uruchomić projekt, sprawdź, czy nowe zadania wyświetlana w wyniku nowego projektu.

Aby przetestować projekt

Naciśnij F5 Aby skompilować i uruchomić projekt.Program Microsoft Project zaczyna się i automatycznie otworzy nowy, pusty projekt.

Podczas budowania projektu, kod jest skompilowany w zespół, który znajduje się w folderze wyjściowym kompilacji projektu.Visual Studio również tworzy zestaw wpisów rejestru, które umożliwiają projektu odkryć i załadować dodatek i konfiguruje ustawienia zabezpieczeń na komputerze deweloperskim, aby włączyć dodatek do uruchomienia.Aby uzyskać więcej informacji, zobacz Office Solution Build Process Overview.
Sprawdź, czy nowe zadanie jest dodany do pustego projektu.
Sprawdź czy następujący tekst pojawia się w Nazwa zadania pola zadania.

Tekst ten został dodany za pomocą kodu.
Zamknij program Microsoft Project.

Czyszczenie projektu

Po zakończeniu opracowanie projektu,-w zestawie, wpisy rejestru i ustawienia zabezpieczeń należy usunąć z komputera rozwoju.W przeciwnym razie zostanie uruchomiony dodatek przy każdym otwarciu programu Microsoft Project na komputerze deweloperskim.

Aby oczyścić projektu

W programie Visual Studio na budować menu, kliknij przycisk Rozwiązanie.

Następne kroki

Teraz, że utworzono podstawowy poziom aplikacji dodatek dla projektu, można dowiedzieć się więcej o opracowanie dodatki z tych tematów:

Ogólnych zadań programistycznych, które można wykonywać w dodatków dla projektu: Programowanie dodatków na poziomie aplikacji.
Za pomocą modelu projektu: Rozwiązania projektu.
Budowanie i debugowanie aplikacji poziom dodatków dla projektu: Kompilowanie rozwiązań pakietu Office.
Wdrażanie aplikacji poziom dodatków dla projektu: Wdrażanie rozwiązania do pakietu Office.