Регистрация библиотеки с помощью диспетчера объектов

Средства просмотра символов, такие как представление классов, обозреватель объектов, браузер вызовов и результаты поиска символов, позволяют просматривать символы в проекте или во внешних компонентах. Символы включают пространства имен, классы, интерфейсы, методы и другие элементы языка. Библиотеки отслеживают эти символы и предоставляют их диспетчеру объектов Visual Studio, который заполняет средства данными.

Диспетчер объектов отслеживает все доступные библиотеки. Перед предоставлением символов для инструментов просмотра символов каждая библиотека должна зарегистрироваться в диспетчере объектов.

Как правило, вы регистрируете библиотеку при загрузке VSPackage. Однако это можно сделать в другое время по мере необходимости. Отмена регистрации библиотеки при завершении работы VSPackage.

Чтобы зарегистрировать библиотеку RegisterLibrary , используйте метод. Для управляемой библиотеки кода используйте RegisterSimpleLibrary этот метод.

Чтобы отменить регистрацию библиотеки, используйте UnregisterLibrary этот метод.

Чтобы получить ссылку на диспетчер объектов, IVsObjectManager2передайте SVsObjectManager идентификатор службы методу GetService .

Регистрация и отмена регистрации библиотеки с помощью диспетчера объектов

Регистрация библиотеки в диспетчере объектов

1. Создайте библиотеку.

   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. Получите ссылку на объект IVsObjectManager2 типа и вызовите 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
   

Отмена регистрации библиотеки с помощью диспетчера объектов

1. Получите ссылку на объект IVsObjectManager2 типа и вызовите 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
   

Связанный контент

• Расширяемость устаревшей языковой службы
• Поддержка инструментов просмотра символов
• Практическое руководство. Предоставление списков символов, предоставляемых библиотекой диспетчеру объектов