interface IManagedAddin

  • Article

Implémentez l’interface IManagedAddin pour créer un composant qui charge des compléments VSTO managés. Cette interface a été ajoutée dans le système microsoft Bureau Microsoft 2007.

Syntaxe

[
    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éthodes

Le tableau suivant répertorie les méthodes définies par l’interface IManagedAddin.

Nom Description
IManagedAddin::Load Appelée quand une application Microsoft Office charge un complément VSTO géré.
IManagedAddin ::Unload Appelée juste avant qu’une application Microsoft Office décharge un complément VSTO géré.

Notes

Microsoft application Office lications, à partir du système Microsoft Bureau 2007, utilisez l’interface IManagedAddin pour charger Bureau compléments VSTO. Vous pouvez implémenter l’interface IManagedAddin pour créer votre propre chargeur de complément VSTO et votre runtime pour les compléments VSTO managés, au lieu d’utiliser le chargeur de complément VSTO (VSTOLoader.dll) et Visual Studio Tools pour Office runtime. Pour plus d'informations, consultez Architecture of VSTO Add-ins.

Chargement des compléments managés

Les étapes suivantes se produisent au démarrage d’une application :

  1. L’application découvre les compléments VSTO en recherchant des entrées sous la clé de Registre suivante :

    HKEY_CURRENT_USER\Software\Microsoft\Bureau\nom> de< l’application\Addins\

    Chaque entrée sous cette clé de Registre est un ID unique du complément VSTO. En règle générale, il s’agit du nom de l’assembly du complément VSTO.

  2. L’application cherche une entrée Manifest sous l’entrée de chaque complément VSTO.

    Les compléments VSTO managés peuvent stocker le chemin complet d’un manifeste dans l’entrée sous HKEY_CURRENT_USER\Software\Microsoft\Bureau\<nom> de l’application\Addins\<add-in ID>.Manifest Un manifeste est un fichier (en général, un fichier XML) qui fournit des informations qui sont utilisées pour charger le complément VSTO.

  3. Si l’application trouve une entrée Manifest , elle essaie de charger un composant de chargeur de complément VSTO géré. L’application effectue cette opération en essayant de créer un objet COM qui implémente l’interface IManagedAddin.

    Le runtime Visual Studio Tools pour Office inclut un composant de chargeur de complément VSTO (VSTOLoader.dll), ou vous pouvez créer votre propre runtime en implémentant l’interface IManagedAddin.

  4. L’application appelle la méthode IManagedAddin::Load et passe la valeur de l’entrée Manifest .

  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é.

    Pour plus d’informations sur les clés de Registre que Microsoft application Office lications utilisent pour découvrir et charger des compléments VSTO managés, consultez les entrées de Registre pour les compléments VSTO.

Conseils pour implémenter IManagedAddin

Si vous implémentez IManagedAddin, vous devez inscrire la DLL qui contient l’implémentation à l’aide du CLSID suivant :

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

Microsoft application Office lications utilisent ce CLSID pour créer l’objet COM qui implémente IManagedAddin.

Attention

Ce CLSID est également utilisé par VSTOLoader.dll dans le runtime Visual Studio Tools pour Office. Par conséquent, si vous utilisez IManagedAddin pour créer votre propre chargeur de complément VSTO et votre composant d’exécution, vous ne pouvez pas déployer votre composant sur des ordinateurs exécutant des compléments VSTO qui s’appuient sur le runtime Visual Studio Tools pour Office.

Voir aussi