Udostępnij za pośrednictwem


Składniki projektu dodatków

Dodatki Visual Studio zostały zaniechane w programie Visual Studio 2013.Dodatki należy uaktualniać do pakietu rozszerzenia VSPackage.Aby uzyskać więcej informacji na temat uaktualniania, zobacz Często zadawane pytania: konwertowanie dodatków na rozszerzenia pakietu VSPackage.

Projekty dodatków są projektami Biblioteki klas, które są tworzone za pomocą Kreatora dodatków i kompilowane w bibliotekach DLL.Projekty dodatków zawierają plik kodu źródłowego o nazwie Połącz, który jest również nazwą klasy.Połącz klasy implementuje interfejs o nazwie IDTExtensibility2 polecenia która przechodzi między dodatek i Visual Studio zintegrowanego środowiska programistycznego (IDE).

IDTExtensibility2 zawiera pięć metod, które po wdrożeniu, działają jako wydarzenia.

Metoda

Opis

OnConnection

Metoda ta jest wywoływana po załadowaniu dodatku w Visual Studio.

OnStartupComplete

Metoda ta jest wywoływana, gdy Visual Studio zakończy ładowanie.

OnAddInsUpdate

Metoda ta jest wywoływana, gdy dodatek ładuje i zwalnia z Visual Studio.

OnBeginShutdown

Metoda ta jest wywoływana, gdy Visual Studio jest zamknięty.

OnDisconnection

Metoda ta jest wywoływana po rozładowaniu dodatku w Visual Studio.

Oprócz interfejsu IDTExtensibility2, interfejs IDTCommandTarget jest automatycznie wprowadzany po zaznaczeniu opcji interfejsu użytkownika podczas korzystania z Kreatora dodatków do tworzenia dodatków.Jeśli zdecydujesz się na stworzenie lub modyfikację pasków poleceń w dodatku, należy także zaimplementować przestrzeń nazw Microsoft.VisualStudio.CommandBars.

Metoda OnConnection

OnConnection Metoda jest zdecydowanie najważniejszą metodą używaną w projekcie dodatku, ponieważ jest ona wywoływana za każdym razem, gdy dodatek jest załadowany.Ponadto jest używany do wywoływania innego kodu automatyzacji w dodatku.The OnConnection metoda przechodzi przez cztery parametry: Application, ConnectMode, AddInInst, i custom.Application reprezentuje Visual Studio IDE.Występuje jako obiekt DTE2 o nazwie _applicationObject.Ten obiekt reprezentuje główny obiekt w modelu podstawowym automatyzacji i zapewnia dostęp do wszystkich typów i członków.ConnectMode (których wartości znajdują się w Extensibility.extConnectMode) przedstawia sposób ładowania dodatku; tzn., za pośrednictwem wiersza polecenia, otwierając rozwiązanie itd.AddInInst reprezentuje sam dodatek.custom parametr jest tablicą, w której można opcjonalnie przekazać dane do dodatku.

Oprócz inicjowania tych zmiennych, OnConnection również zawiera kod, aby utworzyć polecenie dla dodatku w menu Narzędzia w przypadku wybrania tej opcji podczas tworzenia go w Kreatorze dodatku.

Inne metody dodatków

Pozostałe cztery dodatki metody, które są wprowadzone przez Dodatek Kreatora, są domyślnie puste.Aby obsłużyć powiązane wydarzenia dodatków, można użyć metod reagowania na nie.Na przykład, można dodać kod do metody OnAddInsUpdate, aby wysłać komunikat z powiadomieniem do innej procedury, gdy dodatek jest zamknięty.Można wywołać OnBeginShutdown do wykonywania oczyszczania zadań, kiedy Visual Studio IDE jest wyłączony.

Podczas tworzenia dodatku i sprawdzania opcji "Czy chcesz utworzyć polecenie paska dla dodatku?" (który tworzy polecenie dla dodatku w menu Narzędzia ), IDTCommandTarget interfejs jest implementowany.Dwie dodatkowe metody — QueryStatus i Exec — są dodawane do projektu Dodaj do obsługi zadań polecenia.Metody te zawierają niewielką ilość kodu, co ma na celu pomóc w umieszczeniu polecenia menu Narzędzia i reagowania na kliknięcia przez użytkownika.QueryStatus powiadamia dodatek o dostępności polecenia.Exec metoda jest wywoływana, gdy użytkownik kliknie polecenie dodatek w menu Narzędzia, więc tam należy dodać kod, aby odpowiedzieć na to zdarzenie.

Zobacz też

Koncepcje

Projekty rozszerzalności

Inne zasoby

Tworzenie dodatków i kreatorów