AddInProcess Класс

Определение

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

System.AddIn.Hosting

Сборка:

System.AddIn.dll

Предоставляет внешний процесс для выполнения надстроек вне процесса основного приложения.

public ref class AddInProcess sealed

public sealed class AddInProcess

type AddInProcess = class

Public NotInheritable Class AddInProcess

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

Object

AddInProcess

Примеры

В следующем примере надстройка активируется во внешнем процессе.

// Create an external process.
AddInProcess pExternal = new AddInProcess();

// Activate an add-in in the external process
// with a full trust security level.
Calculator CalcAddIn4 =
    selectedToken.Activate<Calculator>(pExternal,
    AddInSecurityLevel.FullTrust);

// Show that the add-in is an external process
// by verifying that it is not in the current (host's) process.
AddInController AddinCtl = AddInController.GetAddInController(CalcAddIn4);
Console.WriteLine("Add-in in host's process: {0}",
    AddinCtl.AddInEnvironment.Process.IsCurrentProcess);

' Create an external process.
Dim pExternal As New AddInProcess()

' Activate an add-in in the external process
' with a full trust security level.
Dim CalcAddIn4 As Calculator = _
    selectedToken.Activate(Of Calculator)(pExternal, _
        AddInSecurityLevel.FullTrust)

' Show that the add-in is an external process
' by verifying that it is not in the current (host's) process.
Dim AddinCtl As AddInController = AddInController.GetAddInController(CalcAddIn4)
Console.WriteLine("Add-in in host's process: {0}", _
 AddinCtl.AddInEnvironment.Process.IsCurrentProcess)

Комментарии

Чтобы активировать надстройку во внешнем процессе, передайте AddInProcess объект в соответствующую AddInToken.Activate<T>(AddInProcess, PermissionSet) перегрузку метода.

Исполняемый файл, запускающий надстройку, получается из одного из двух файлов, установленных с платформа .NET Framework в каталоге Windows. По умолчанию используется исполняемый файл, соответствующий битам на слово ведущем приложении. Если узел является 64-разрядным процессом, выполняется AddInProcess.exe; в противном случае выполняется AddInProcess32.exe. Чтобы указать способ выбора исполняемого файла, используйте AddInProcess(Platform) конструктор для создания AddInProcess объекта .

Конструкторы

AddInProcess()	Инициализирует новый экземпляр класса AddInProcess.
AddInProcess(Platform)	Инициализирует новый экземпляр класса AddInProcess с указанием разрядности слова процесса, в котором выполняется надстройка.

Свойства

IsCurrentProcess	Возвращает значение, указывающее, представляет ли текущий объект AddInProcess процесс ведущего приложения.
KeepAlive	Получает или задает значение, указывающее, нужно ли поддерживать активность внешнего процесса.
Platform	Получает разрядность слова процесса, в котором выполняется внепроцессная надстройка.
ProcessId	Возвращает идентификатор процесса для внешнего процесса.
StartupTimeout	Получает или задает время, выделяемое на запуск процесса, в секундах.

Методы

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

События

ShuttingDown

Возникает, когда процесс, представленный объектом AddInProcess скоро будет закрыт.

См. также раздел

• Надстройки и расширяемость