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)