Udostępnij za pośrednictwem

Metoda IVsPackage.Close — ()

  • Artykuł

 

Zamyka VSPackage, zwalnia wskaźników interfejsów buforowany i unadvises ujść zdarzeń.

Przestrzeń nazw:   Microsoft.VisualStudio.Shell.Interop
Zestaw:  Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

int Close()

int Close()

abstract Close : unit -> int

Function Close As Integer

Wartość zwracana

Type: System.Int32

Jeśli metoda się powiedzie, zwraca S_OK.Jeśli nie powiedzie się, zwraca kod błędu.

Uwagi

Ta metoda będzie oczyścić żadnych odwołań zewnętrznych i przerwać wszelkie odniesienia liczenia cykli.Po wszystkich VSPackages Close o nazwie metody, środowiska zwalnia all proffered usług.

Należy przestrzegać następujących semantykę w realizacji Close metody:

  • Po załadowaniu VSPackage, nie zostanie on zwolniony, dopóki nie zakończy się aplikacji środowiska.Jeśli jeden VSPackage Close metoda jest wywoływana, następnie na VSPackage Close wywoływana jest metoda.Oznacza to, że w danym VSPackage obsługuje jego własnymi wymogami zamknięcia i oczyszczania.

  • VSPackage spowoduje oczyszczenie wszystkie odwołania zewnętrzne.Zamknij metoda jest przeznaczona do podziału zliczanie cykli wszystkich odwołań i aby zachęcić wszystkie odniesienia zlicza, aby ostatecznie osiągnąć zero.Powinny zwolnić wskaźników interfejsów buforowane, unadvise ujść zdarzeń i dostarczyć inne obowiązki niezbędne oczyszczanie.VSPackages należy upewnić się, że honor wszystkich zliczanie odwołań.VSPackage nie można usunąć obiektów podczas Close wywoływana jest metoda.

  • Wszystkie usługi, środowiska naturalnego i VSPackages wszystkie załadowane pozostają dostępne podczas Close implementacja metody.VSPackage, muszą jednak oczekiwać że usługi są niedostępne, że jedynymi metodami, które są gwarantowane została wykonana pomyślnie, są unadvise metody.Większość usług oczekuje się nie powieść, doradza nowych ujść zdarzeń lub utworzyć nowe zasoby.

  • Nie należy wywoływać VSPackage RevokeService metody w realizacji Close metody.Wszystkie usługi są prawdopodobnie pozostają dostępne na czas trwania wywołania Zamknij na VSPackages.Automatycznie odwołuje środowiska i udostępnia usługi po wywołaniu VSPackages Close.

Jest pozbawione sensu zwraca błąd z Close.Wszystkie wartości błędów zwrotu są ignorowane i środowiska naturalnego kończy proces zamykania po jego uruchomieniu.VSPackage ma możliwość zatrzymania procesu zamykania w jego QueryClose metody.

Jeśli pakiet musi zablokować zamknięcia IDE powinny wdrożyć IVsPackage2.

Zobacz też

Interfejs IVsPackage
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku