ObjectExtenders.RegisterExtenderProvider - метод

Статья
08/11/2011

Регистрирует поставщик-расширитель для указанной категории расширителей.

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)

Синтаксис

'Декларация
Function RegisterExtenderProvider ( _
    ExtenderCATID As String, _
    ExtenderName As String, _
    ExtenderProvider As IExtenderProvider, _
    LocalizedName As String _
) As Integer

int RegisterExtenderProvider(
    string ExtenderCATID,
    string ExtenderName,
    IExtenderProvider ExtenderProvider,
    string LocalizedName
)

int RegisterExtenderProvider(
    [InAttribute] String^ ExtenderCATID, 
    [InAttribute] String^ ExtenderName, 
    [InAttribute] IExtenderProvider^ ExtenderProvider, 
    [InAttribute] String^ LocalizedName
)

abstract RegisterExtenderProvider : 
        ExtenderCATID:string * 
        ExtenderName:string * 
        ExtenderProvider:IExtenderProvider * 
        LocalizedName:string -> int

function RegisterExtenderProvider(
    ExtenderCATID : String, 
    ExtenderName : String, 
    ExtenderProvider : IExtenderProvider, 
    LocalizedName : String
) : int

Параметры

ExtenderCATID
Тип: System.String
Обязательный.Идентификатор CATID расширителя.

ExtenderName
Тип: System.String
Обязательный.Имя расширителя.Имя расширителя является программным и используется при вызове метода GetExtender.

ExtenderProvider
Тип: EnvDTE.IExtenderProvider
Обязательный.Поставщик-расширитель, реализующий интерфейс IExtenderProvider.

LocalizedName
Тип: System.String
Необязательный.Локализованное отображаемое имя расширителя.

Возвращаемое значение

Тип: System.Int32
Возвращает целочисленный Сookie, определяющий регистрацию.Этот Сookie должен быть передан обратно во время UnregisterExtenderProvider.

Заметки

Метод RegisterExtenderProvider используется поставщиком-расширителем, чтобы динамически регистрировать себя под определенным идентификатором CATID и именем с объектом ObjectExtenders. Поставщик-расширитель может регистрировать более одного расширителя, используя один или несколько CATID.

Существует два способа регистрации поставщиков-расширителей:

Статически, создав соответствующий подраздел идентификатора категории (CATID) расширителя в разделе реестра "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0\Extenders" во время установки надстройки.
Динамически, вызвав данный метод в методе OnConnection надстройки.

Примечание

Поставщики-расширители, зарегистрированные динамически, должны удалять регистрацию самостоятельно, вызвав метод UnregisterExtenderProvider во время завершения работы.Поставщикам, зарегистрированным статически, это делать не нужно.

Безопасность платформы .NET Framework

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