Rejestrowanie biblioteki w menedżerze obiektów

Narzędzia przeglądania symboli, takie jak Widok klas, Przeglądarka obiektów, Przeglądarka wywołań i Wyniki symboli wyszukiwania, umożliwiają wyświetlanie symboli w projekcie lub w składnikach zewnętrznych. Symbole obejmują przestrzenie nazw, klasy, interfejsy, metody i inne elementy języka. Biblioteki śledzą te symbole i uwidaczniają je w menedżerze obiektów programu Visual Studio, który wypełnia narzędzia danymi.

Menedżer obiektów śledzi wszystkie dostępne biblioteki. Każda biblioteka musi zarejestrować się w menedżerze obiektów przed udostępnieniem symboli narzędzi do przeglądania symboli.

Zazwyczaj biblioteka jest rejestrowana podczas ładowania pakietu VSPackage. Jednak można to zrobić w innym czasie, zgodnie z potrzebami. Wyrejestrowywanie biblioteki po zamknięciu pakietu VSPackage.

Aby zarejestrować bibliotekę, użyj RegisterLibrary metody . W przypadku biblioteki kodu zarządzanego użyj RegisterSimpleLibrary metody .

Aby wyrejestrować bibliotekę, użyj UnregisterLibrary metody .

Aby uzyskać odwołanie do menedżera obiektów, IVsObjectManager2przekaż SVsObjectManager identyfikator usługi do GetService metody .

Rejestrowanie i wyrejestrowywanie biblioteki za pomocą menedżera obiektów

Aby zarejestrować bibliotekę za pomocą menedżera obiektów

1. Utwórz bibliotekę.

   C#

   private CallBrowser.Library m_CallBrowserLibrary = null;
   private uint m_nLibraryCookie = 0;
   // Create Library.
   m_CallBrowserLibrary = new CallBrowser.Library();
   
   

   VB

   Private m_CallBrowserLibrary As CallBrowser.Library = Nothing
   Private m_nLibraryCookie As UInteger = 0
   ' Create Library.
   m_CallBrowserLibrary = New CallBrowser.Library()
   

2. Uzyskaj odwołanie do obiektu IVsObjectManager2 typu i wywołaj metodę RegisterSimpleLibrary .

   C#

   private void RegisterLibrary()
   {
       if (m_nLibraryCookie != 0)
           throw new Exception("Library already registered with Object Manager");
   
       // Obtain a reference to IVsObjectManager2 type object.
       IVsObjectManager2 objManager =
                         GetService(typeof(SVsObjectManager)) as IVsObjectManager2;
       if (objManager == null)
           throw new NullReferenceException("GetService failed for SVsObjectManager");
   
       try
       {
           int hr =
               objManager.RegisterSimpleLibrary(m_CallBrowserLibrary,
                                                out m_nLibraryCookie);
               Microsoft.VisualStudio.ErrorHandler.ThrowOnFailure(hr);
       }
       catch (Exception e)
       {
           // Code to handle any CLS-compliant exception.
           Trace.WriteLine(e.Message);
           throw;
       }
   }
   
   

   VB

   Private Sub RegisterLibrary()
       If m_nLibraryCookie <> 0 Then
           Throw New Exception("Library already registered with Object Manager")
       End If
   
       ' Obtain a reference to IVsObjectManager2 type object.
       Dim objManager As IVsObjectManager2 = TryCast(GetService(GetType(SVsObjectManager)), IVsObjectManager2)
       If objManager Is Nothing Then
           Throw New NullReferenceException("GetService failed for SVsObjectManager")
       End If
   
       Try
           Dim hr As Integer = objManager.RegisterSimpleLibrary(m_CallBrowserLibrary, m_nLibraryCookie)
           Microsoft.VisualStudio.ErrorHandler.ThrowOnFailure(hr)
       Catch e As Exception
           ' Code to handle any CLS-compliant exception.
           Trace.WriteLine(e.Message)
           Throw
       End Try
   End Sub
   

Aby wyrejestrować bibliotekę za pomocą menedżera obiektów

1. Uzyskaj odwołanie do obiektu IVsObjectManager2 typu i wywołaj metodę UnregisterLibrary .

   C#

   private void UnregisterLibrary()
   {
       if (m_nLibraryCookie != 0)
       {
           // Obtain a reference to IVsObjectManager2 type object.
           IVsObjectManager2 objManager = GetService(typeof(SVsObjectManager)) as IVsObjectManager2;
           if (objManager == null)
               throw new NullReferenceException("GetService failed for SVsObjectManager");
   
           try
           {
               objManager.UnregisterLibrary(m_nLibraryCookie);
           }
           catch (Exception e)
           {
               // Code to handle any CLS-compliant exception.
               Trace.WriteLine(e.Message);
               throw;
           }
           finally
           {
               m_nLibraryCookie = 0;
           }
       }
   }
   
   

   VB

   Private Sub UnregisterLibrary()
       If m_nLibraryCookie <> 0 Then
           ' Obtain a reference to IVsObjectManager2 type object.
           Dim objManager As IVsObjectManager2 = TryCast(GetService(GetType(SVsObjectManager)), IVsObjectManager2)
           If objManager Is Nothing Then
               Throw New NullReferenceException("GetService failed for SVsObjectManager")
           End If
   
           Try
               objManager.UnregisterLibrary(m_nLibraryCookie)
           Catch e As Exception
               ' Code to handle any CLS-compliant exception.
               Trace.WriteLine(e.Message)
               Throw
           Finally
               m_nLibraryCookie = 0
           End Try
       End If
   End Sub
   

Powiązana zawartość

• Rozszerzalność starszej wersji usługi językowej
• Obsługa narzędzi do przeglądania symboli
• Instrukcje: uwidacznianie list symboli dostarczonych przez bibliotekę do menedżera obiektów