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, passez 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

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

Propriétés

IsCurrentProcess	Obtient une valeur qui indique si l’objet AddInProcess actuel représente le processus d’application hôte.
KeepAlive	Obtient ou définit une valeur qui indique s'il faut garder le processus externe actif.
Platform	Obtient les bits par mot du processus dans lequel le complément hors processus est exécuté.
ProcessId	Obtient l'ID du processus externe.
StartupTimeout	Obtient ou définit le nombre de secondes à attendre avant le démarrage du processus.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Shutdown()	Force l'arrêt du 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

ShuttingDown

Se produit lorsque le processus représenté par l'objet AddInProcess est sur le point de s'arrêter.

Voir aussi

• Compléments et extensibilité