IExtenderProviderUnk.GetExtender - метод

Статья
11/01/2012

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

Пространство имен: 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
Тип: System.String
Идентификатор категории (CATID) для запрашиваемого расширителя.

ExtenderName
Тип: System.String
Имя запрашиваемого расширителя.

ExtendeeObject
Тип: System.Object
Расширяемый объект.

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

Cookie
Тип: System.Int32
Файл cookie, идентифицирующий расширитель.

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

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

Заметки

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

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

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

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

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

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

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