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 объектом, завершается. |