AddInController Класс

Определение

Пространство имен:

System.AddIn.Hosting

Сборка:

System.AddIn.dll

Предоставляет доступ к надстройке для широкого круга задач.

public ref class AddInController sealed

public sealed class AddInController

type AddInController = class

Public NotInheritable Class AddInController

Наследование

Object

AddInController

Примеры

В следующем примере надстройка активируется в той же среде, что и ранее активированная надстройка с помощью AddInController объекта .

// Get the AddInController of a
// currently actived add-in (CalcAddIn).
AddInController aiController = AddInController.GetAddInController(CalcAddIn);

// Select another token.
AddInToken selectedToken2 = ChooseAddIn(tokens);

// Activate a second add-in, CalcAddIn2, in the same
// appliation domain and process as the first add-in by passing
// the first add-in's AddInEnvironment object to the Activate method.
AddInEnvironment aiEnvironment = aiController.AddInEnvironment;
Calculator CalcAddIn2 =
    selectedToken2.Activate<Calculator>(aiEnvironment);

// Get the AddInController for the second add-in to compare environments.
AddInController aiController2 = AddInController.GetAddInController(CalcAddIn2);
Console.WriteLine("Add-ins in same application domain: {0}", aiController.AppDomain.Equals(aiController2.AppDomain));
Console.WriteLine("Add-ins in same process: {0}", aiEnvironment.Process.Equals(aiController2.AddInEnvironment.Process));

' Get the AddInController of a 
' currently activated add-in (CalcAddIn).
Dim aiController As AddInController = AddInController.GetAddInController(CalcAddIn)

' Select another token.
Dim selectedToken2 As AddInToken = ChooseAddIn(tokens)

' Activate a second add-in, CalcAddIn2, in the same
' appliation domain and process as the first add-in by passing
' the first add-in's AddInEnvironment object to the Activate method.

Dim aiEnvironment As AddInEnvironment = aiController.AddInEnvironment
Dim CalcAddIn2 As Calculator = _
    selectedToken2.Activate(Of Calculator)(aiEnvironment)

' Get the AddInController for the second add-in to compare environments.
Dim aiController2 As AddInController = AddInController.GetAddInController(CalcAddIn2)

Console.WriteLine("Add-ins in same application domain: {0}", _
    aiController.AppDomain.Equals(aiController2.AppDomain))
Console.WriteLine("Add-ins in same process: {0}", _
    aiEnvironment.Process.Equals(aiController2.AddInEnvironment.Process))

Комментарии

Используйте этот класс для выполнения следующих задач:

• AddInEnvironment Используйте свойство , чтобы получить AddInEnvironment объект для надстройки. Затем используйте этот объект для активации других надстроек в том же домене приложения и обработки, что и исходная надстройка.

• AppDomain Используйте свойство , чтобы получить AppDomain объект для надстройки. Затем используйте этот объект для активации других надстроек в том же домене приложения, что и исходная надстройка. Обратите внимание, что из-за ограничений удаленного взаимодействия между процессами этот сценарий не будет работать с надстройками, которые активируются в отдельном процессе.

• Используйте свойство для Token получения AddInToken объекта, представляющего надстройку.

• Завершите работу надстройки Shutdown с помощью метода .

Чтобы получить контроллер для надстройки GetAddInController , вызовите метод и передайте экземпляр надстройки в качестве параметра .

Свойства

AddInEnvironment	Возвращает объект AddInEnvironment.
AppDomain	Возвращает домен приложения, содержащий надстройку.
Token	Возвращает токен, представляющий надстройку.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetAddInController(Object)	Получает контроллер для надстройки.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Shutdown()	Отключает надстройку.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)