AddInProcess Classe

Définition

Espace de noms:
System.AddIn.Hosting
Assembly:
System.AddIn.dll

Fournit un processus externe pour l’exécution de compléments hors processus à partir de l’application hôte.

public ref class AddInProcess sealed
public sealed class AddInProcess
type AddInProcess = class
Public NotInheritable Class AddInProcess
Héritage
Object
AddInProcess

Exemples

L’exemple suivant active un complément dans un processus externe.

// 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)

Remarques

Pour activer un complément dans un processus externe, transmettez un AddInProcess objet à la surcharge de méthode appropriée AddInToken.Activate<T>(AddInProcess, PermissionSet) .

L’exécutable qui exécute le complément est obtenu à partir de l’un des deux fichiers installés avec le .NET Framework sous le répertoire Windows. Par défaut, l’exécutable qui correspond aux bits par mot de l’application hôte est utilisé. Si l’hôte est un processus 64 bits, AddInProcess.exe est exécuté ; sinon, AddInProcess32.exe est exécuté. Pour spécifier la façon dont l’exécutable est sélectionné, utilisez le AddInProcess(Platform) constructeur pour créer l’objet AddInProcess .

Constructeurs

Nom Description
AddInProcess()

Initialise une nouvelle instance de la classe AddInProcess.
AddInProcess(Platform)

Initialise une nouvelle instance de la AddInProcess classe, en spécifiant les bits par mot du processus dans lequel le complément s’exécute.

Propriétés

Nom Description
IsCurrentProcess

Obtient une valeur qui indique si l’objet actuel AddInProcess représente le processus d’application hôte.
KeepAlive

Obtient ou définit une valeur qui indique s’il faut conserver le processus externe actif.
Platform

Obtient les bits par mot du processus dans lequel le complément out-of-process est exécuté.
ProcessId

Obtient l’ID de processus du processus externe.
StartupTimeout

Obtient ou définit le nombre de secondes à autoriser le démarrage du processus.

Méthodes

Nom Description
Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
Shutdown()

Arrête de force le processus externe.
Start()

Démarre le processus externe.
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

Événements

Nom Description
ShuttingDown

Se produit lorsque le processus représenté par l’objet AddInProcess est sur le point d’être arrêté.

S’applique à