IExtenderProviderUnk.GetExtender - метод

Статья
05/17/2015

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

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

Синтаксис

'Декларация
Function GetExtender ( _
    ExtenderCATID As String, _
    ExtenderName As String, _
    ExtendeeObject As Object, _
    ExtenderSite As IExtenderSite, _
    Cookie As Integer _
) As Object

Object GetExtender(
    string ExtenderCATID,
    string ExtenderName,
    Object ExtendeeObject,
    IExtenderSite ExtenderSite,
    int Cookie
)

Object^ GetExtender(
    [InAttribute] String^ ExtenderCATID, 
    [InAttribute] String^ ExtenderName, 
    [InAttribute] Object^ ExtendeeObject, 
    [InAttribute] IExtenderSite^ ExtenderSite, 
    [InAttribute] int Cookie
)

abstract GetExtender : 
        ExtenderCATID:string * 
        ExtenderName:string * 
        ExtendeeObject:Object * 
        ExtenderSite:IExtenderSite * 
        Cookie:int -> Object

function GetExtender(
    ExtenderCATID : String, 
    ExtenderName : String, 
    ExtendeeObject : Object, 
    ExtenderSite : IExtenderSite, 
    Cookie : int
) : Object

Параметры

ExtenderCATID
Тип: String

Идентификатор категории (CATID) для запрашиваемого расширителя.

ExtenderName
Тип: String

Имя запрашиваемого расширителя.

ExtendeeObject
Тип: Object

Расширяемый объект.

ExtenderSite
Тип: EnvDTE.IExtenderSite

Сайт расширителя, представленный интерфейсом IExtenderSite.

Cookie
Тип: Int32

Файл cookie, идентифицирующий расширитель.

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

Тип: Object
Расширитель.

Заметки

Метод GetExtender возвращает расширитель для определенного идентификатора CATID и имени указанного расширяемого экземпляра. Этот метод вызывается только если метод CanExtend возвращает значение true.

Поставщик-расширитель должен хранить переданный объект ExtenderSite и объект Cookie.

Предупреждение

Диспетчер расширителей поддерживает внутренний кэш объектов расширителей и должен уведомляться об их уничтожении.Метод NotifyDelete необходимо вызывать сразу же после уничтожения объектов расширителей.Не следует дожидаться бездействия приложения, потому что другие компоненты Visual Studio могут попытаться получить доступ к уничтоженному объекту расширителя, прежде чем будет вызван этот метод.Если это произойдет, возможно аварийное завершение работы Visual Studio.

Примечание

Расширяемый объект передается как интерфейс IUnknown.

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

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