Registrace knihovny ve správci objektů

Nástroje pro procházení symbolů, jako je zobrazení tříd, prohlížeč objektů, prohlížeč volání a výsledky hledání symbolů, umožňují zobrazit symboly v projektu nebo v externích komponentách. Symboly zahrnují obory názvů, třídy, rozhraní, metody a další prvky jazyka. Knihovny tyto symboly sledují a zveřejňují je správci objektů sady Visual Studio, který naplní nástroje daty.

Správce objektů sleduje všechny dostupné knihovny. Každá knihovna se musí před poskytnutím symbolů pro nástroje pro procházení symbolů zaregistrovat ve správci objektů.

Obvykle zaregistrujete knihovnu při načtení balíčku VSPackage. Dá se to ale provést v jiném čase podle potřeby. Zrušíte registraci knihovny při vypnutí balíčku VSPackage.

Pokud chcete zaregistrovat knihovnu, použijte metodu RegisterLibrary . Pro spravovanou knihovnu kódu použijte metodu RegisterSimpleLibrary .

Pokud chcete zrušit registraci knihovny, použijte metodu UnregisterLibrary .

Chcete-li získat odkaz na správce objektů, IVsObjectManager2předejte SVsObjectManager ID služby metodě GetService .

Registrace a zrušení registrace knihovny ve správci objektů

Registrace knihovny ve správci objektů

1. Vytvořte knihovnu.

   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. Získejte odkaz na objekt IVsObjectManager2 typu a zavolejte metodu 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
   

Zrušení registrace knihovny pomocí správce objektů

1. Získejte odkaz na objekt IVsObjectManager2 typu a zavolejte metodu 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
   

Související obsah

• Rozšiřitelnost služby starší verze jazyka
• Nástroje pro procházení symbolů podpory
• Postupy: Zveřejnění seznamů symbolů poskytovaných knihovnou správci objektů