AddInProcess Класс

Определение

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

public ref class AddInProcess sealed
public sealed class AddInProcess
type AddInProcess = class
Public NotInheritable Class AddInProcess
Наследование
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. По умолчанию используется исполняемый файл, соответствующий bits-per-word ведущего приложения. Если узел является 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 объектом, завершается.

Применяется к