interface IManagedAddinIManagedAddin interface

Implémentez l’interface IManagedAddin pour créer un composant qui charge gérée des Compléments VSTO. Cette interface a été ajoutée dans la version 2007 de Microsoft Office System.Implement the IManagedAddin interface to create a component that loads managed VSTO Add-ins. This interface was added in the 2007 Microsoft Office system.

SyntaxeSyntax

[  
    object,  
    uuid(B9CEAB65-331C-4713-8410-DDDAF8EC191A),  
    pointer_default(unique),  
    oleautomation  
]  
interface IManagedAddin : IUnknown  
{  
    HRESULT Load(  
        [in] BSTR bstrManifestURL,   
        [in] IDispatch *pdispApplication);  
    HRESULT Unload();  
};  

MéthodesMethods

Le tableau suivant répertorie les méthodes qui sont définies par l’interface IManagedAddin.The following table lists the methods that are defined by the IManagedAddin interface.

NameName DescriptionDescription
IManagedAddin::LoadIManagedAddin::Load Appelée quand une application Microsoft Office charge un complément VSTO géré.Called when a Microsoft Office application loads a managed VSTO Add-in.
IManagedAddin::UnloadIManagedAddin::Unload Appelée juste avant qu’une application Microsoft Office décharge un complément VSTO géré.Called just before a Microsoft Office application unloads a managed VSTO Add-in.

NotesRemarks

Les applications Microsoft Office, en commençant par le système Microsoft Office 2007, utilisent l’interface IManagedAddin pour charger les compléments Office VSTO. Vous pouvez implémenter l’interface IManagedAddin pour créer vos propres chargeur de complément VSTO et de runtime pour gérés des Compléments VSTO, au lieu d’utiliser le chargeur de complément VSTO (VSTOLoader.dll) et Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime.Microsoft Office applications, starting with the 2007 Microsoft Office system, use the IManagedAddin interface to help load Office VSTO Add-ins. You can implement the IManagedAddin interface to create your own VSTO Add-in loader and runtime for managed VSTO Add-ins, instead of using the VSTO Add-in loader (VSTOLoader.dll) and Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime. Pour plus d'informations, consultez Architecture of VSTO Add-ins.For more information, see Architecture of VSTO Add-ins.

Comment les compléments managés sont chargés.How managed Add-ins are loaded

Les étapes suivantes se produisent au démarrage d’une application :The following steps occur when an application starts:

  1. L’application découvre les compléments VSTO en recherchant des entrées sous la clé de Registre suivante :The application discovers VSTO Add-ins by looking for entries under the following registry key:

    **HKEY_CURRENT_USER\Software\Microsoft\Office\<nom_application > \Addins****HKEY_CURRENT_USER\Software\Microsoft\Office\<application name> \Addins**

    Chaque entrée sous cette clé de Registre est un ID unique du complément VSTO.Each entry under this registry key is a unique ID of the VSTO Add-in. En règle générale, il s’agit du nom de l’assembly du complément VSTO.Typically, this is the name of the VSTO Add-in assembly.

  2. L’application cherche une entrée Manifest sous l’entrée de chaque complément VSTO.The application looks for a Manifest entry under the entry for each VSTO Add-in.

    Compléments VSTO managés peuvent stocker le chemin d’accès complet d’un manifeste dans le Manifest entrée sous HKEY_CURRENT_USER\Software\Microsoft\Office\<nom_application > \Addins\ <id_complément >.Managed VSTO Add-ins can store the full path of a manifest in the Manifest entry under HKEY_CURRENT_USER\Software\Microsoft\Office\<application name> \Addins\<add-in ID>. Un manifeste est un fichier (en général un fichier XML) qui fournit des informations utilisées pour aider à charger le complément VSTO.A manifest is a file (typically, an XML file) that provides information that is used to help load the VSTO Add-in.

  3. Si l’application trouve une entrée Manifest , elle essaie de charger un composant de chargeur de complément VSTO géré.If the application finds a Manifest entry, the application tries to load a managed VSTO Add-in loader component. Pour cela, l’application essaie de créer un objet COM qui implémente l’interface IManagedAddin.The application does this by trying to create a COM object that implements the IManagedAddin interface.

    Le Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime inclut un composant de chargeur de complément VSTO (VSTOLoader.dll), ou vous pouvez créer le vôtre en implémentant l’interface IManagedAddin.The Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime includes a VSTO Add-in loader component (VSTOLoader.dll), or you can create your own by implementing the IManagedAddin interface.

  4. L’application appelle la méthode IManagedAddin::Load et passe la valeur de l’entrée Manifest .The application calls the IManagedAddin::Load method and passes in the value of the Manifest entry.

  5. La méthode IManagedAddin::Load effectue les tâches requises pour charger le complément VSTO, notamment la configuration du domaine d’application et de la stratégie de sécurité pour le complément VSTO chargé.The IManagedAddin::Load method performs tasks required to load the VSTO Add-in, such as configuring the application domain and security policy for the VSTO Add-in that is being loaded.

    Pour plus d’informations sur le Registre clés qui utilisent des applications Microsoft Office pour découvrir et charger gérés des Compléments VSTO, consultez les entrées de Registre pour les Compléments VSTO.For more information about the registry keys that Microsoft Office applications use to discover and load managed VSTO Add-ins, see Registry entries for VSTO Add-ins.

Conseils pour implémenter IManagedAddinGuidance to implement IManagedAddin

Si vous implémentez IManagedAddin, vous devez inscrire la DLL qui contient l’implémentation à l’aide du CLSID suivant :If you implement IManagedAddin, you must register the DLL that contains the implementation by using the following CLSID:

99D651D7-5F7C-470E-8A3B-774D5D9536AC99D651D7-5F7C-470E-8A3B-774D5D9536AC

Applications Microsoft Office utilisent ce CLSID pour créer l’objet COM qui implémente IManagedAddin.Microsoft Office applications use this CLSID to create the COM object that implements IManagedAddin.

Caution

Ce CLSID est également utilisé par VSTOLoader.dll dans le Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime.This CLSID is also used by VSTOLoader.dll in the Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime. Par conséquent, si vous utilisez IManagedAddin pour créer vos propres chargeur de complément VSTO et le composant d’exécution, vous ne pouvez pas déployer votre composant sur des ordinateurs qui exécutent des Compléments VSTO qui s’appuient sur le Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime.Therefore, if you use IManagedAddin to create your own VSTO Add-in loader and runtime component, you cannot deploy your component to computers that are running VSTO Add-ins that rely on the Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime.

Voir aussiSee also

Référence des API non managées (développement Office dans Visual Studio)Unmanaged API reference (Office development in Visual Studio)