Wskazówki: debugowanie projektu dodatków

W Visual Studio 2013, dodatki są przestarzałe.Zalecamy uaktualnienie dodatków do rozszerzeń VSPackage.Aby uzyskać więcej informacji o uaktualnianiu, zobacz Często zadawane pytania: konwertowanie dodatków na rozszerzenia pakietu VSPackage.

W tym instruktażu pokazano sposób tworzenia podstawowego projektu dodatku Visual Studio i korzystania z punktów przerwania do debugowania.Aby uzyskać więcej informacji, zobacz Breakpoints and Tracepoints.

Dodatki są skompilowanymi aplikacji, które używają modelu obiektowego automatyzacji Visual Studio do manipulowania lub zautomatyzowania zintegrowanego środowiska programistycznego (IDE).Aby uzyskać więcej informacji, zobacz Tworzenie dodatków i kreatorów.

[!UWAGA]

Komputer może polazać inne nazwy lub lokalizacje dla niektórych elementów interfejsu użytkownika Visual Studio w dalszych instrukcjach.Te elementy są determinowane przez numer edycji Twojego programu Visual Studio oraz Twoje ustawienia.Aby uzyskać więcej informacji, zobacz Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Aby utworzyć podstawowy projekt dodatku Visual Studio

1. W pasku menu wybierz Plik, Nowy, Projekt.

   Pojawia się New Project Dialog Box.

2. W okienku Typy projektów rozwiń węzeł Inne typy projektów, następnie wybierz opcję Rozszerzalność.

3. W okienku Szablony wybierz opcję Dodatek do Visual Studio.

4. W polu Nazwa wpisz SimpleAddIn.Wybierz przycisk OK.

   Rozpoczyna się Add-in Wizard.

5. Na stronie Witamy w kreatorze dodatków wybierz przycisk Dalej.

6. Na stronie Wybierz język programowania zaznacz opcję Utwórz dodatek z użyciem Visual C#, a następnie wybierz przycisk Dalej.

7. Na stronie Wybierz aplikację hosta zaakceptuj opcje domyślne, a następnie wybierz przycisk Dalej.

8. Na stronie Wprowadź nazwę i opis wpisz Prosty dodatek jako nazwę, a Ilustruje sposób debugowania prostego dodatku. jako opis.Wybierz przycisk Dalej.

9. Na stronie Wybierz opcje dodatek wybierz opcję Tak, utwórz element menu 'Narzędzia', zaakceptuj pozostałe ustawienia domyślne, a następnie wybierz przycisk Dalej.

10. Na stronie Wybór informacji "Pomoc na temat" wybierz opcję Tak, chciałbym aby dodatek zawierał okno informacji "O programie". opcji, a następnie wybierz przycisk Dalej.

11. Na stronie Podsumowanie wybierz przycisk Zakończ.

    Dodatek Kreator generuje nowy projekt dodatku i otwiera plik Connect.cs.To jest główna klasa, która zawiera kod dla Twojego dodatku.

12. W oknie Eksplorator rozwiązań otwórz menu skrótów dla projektu, wybierz kolejno Dodaj, Odwołania, a następnie wybierz przycisk Dodaj nowe odwołanie.

    Pozwala to na używanie typów w przestrzeni nazw System.Windows.Forms.

    Pojawi się okno dialogowe Add Reference.

13. Na karcie .NET wybierz pozycję System.Windows.Forms.dll, a następnie wybierz przycisk OK.

    W Eksploratorze rozwiązań odwołanie do przestrzeni nazw System.Windows.Forms jest wyświetlany w węźle Odwołania.

    Ta przestrzeń nazw zawiera kod, który jest wymagany, aby wyświetlić Okno komunikatu, które jest używane w następującym przykładzie kodu.

14. W pliku Connect.cs należy dodać następującą instrukcję w górnej części zakresu SimpleAddIn, aby umożliwić łatwiejsze korzystanie z obiektu MessageBox:

    using System.Windows.Forms;
    

15. Dodaj obiekt MessageBox do dodatku przez dodanie MessageBox.Show("Debugging a Simple Add-in"); do metody Exec:

    public void Exec(string commandName,
       vsCommandExecOption executeOption,
       ref object varIn, ref object varOut, ref bool handled)
    {
       handled = false;
       if(executeOption ==
          vsCommandExecOption.vsCommandExecOptionDoDefault)
       {
          if(commandName == "MyAddin1.Connect.MyAddin1")
          {
             handled = true;
             MessageBox.Show("Debugging a Simple Add-in");
             return;
          }
       }
    }
    

16. Wybierz przycisk Zapisz wszystko, aby zapisać swoją pracę.

Aby debugować projekt dodatku Visual Studio

1. W pliku Connect.cs kliknij lewy margines obok instrukcji:

   MessageBox.Show("Debugging a Simple Add-in")
   

   Jest wyświetlana czerwona kropka (która symbolizuje punkt przerwania), a tekst w danym wierszu zostanie wyróżniony na czerwono.

2. Na pasku menu wybierz Debugowanie, Rozpocznij debugowanie.

   Aktualna sesja Visual Studio — sesji debugera — utraci fokus, a program poddawany debugowaniu zostanie otwarty w innym wystąpieniu Visual Studio.

3. Na pasku menu w wystąpieniu debugowania programu Visual Studio wybierz kolejno polecenia Narzędzia > SimpleAddIn do uruchomienia dodatku.

   Przenosi to użytkownika do punktu przerwania, który sam ustalił.

4. Na pasku menu w wystąpieniu debugowania wybierz kolejno polecenia Debuguj > Krok w.

   Fokus przełączany jest z powrotem do debugowanego programu.Otwiera sie okno komunikatu, i wyświetla że dodatek został wykonany.

5. Wybierz przycisk OK w oknie komunikatu, aby je zamknąć.

6. Na pasku menu w wystąpieniu debugowania wybierz kolejno polecenia Debuguj > Kontynuuj.

   Zamknij wystąpienie debugowania programu Visual Studio.

7. W pliku Connect.cs usuń punkt przerwania obok instrukcji MessageBox.

Zobacz też

Inne zasoby

Tworzenie dodatków i kreatorów

Odwołanie do automatyzacji i rozszerzalności