interfaccia IManagedAddin

  • Articolo

Implementare l'interfaccia IManagedAddin per creare un componente che carica i componenti aggiuntivi VSTO gestiti. Questa interfaccia è stata aggiunta nel sistema di Microsoft Office 2007.

Sintassi

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

Metodi

Nella tabella seguente sono elencati i metodi definiti dall'interfaccia IManagedAddin.

Nome Descrizione
IManagedAddin::Load Chiamato quando un'applicazione di Microsoft Office carica un componente aggiuntivo VSTO gestito.
IManagedAddin::Unload Chiamato appena prima che un'applicazione di Microsoft Office scarichi un componente aggiuntivo VSTO gestito.

Osservazioni:

Microsoft app Office lications, a partire dal sistema di Microsoft Office 2007, usare l'interfaccia IManagedAddin per caricare i componenti aggiuntivi VSTO di Office. È possibile implementare l'interfaccia IManagedAddin per creare un caricatore e un runtime del componente aggiuntivo VSTO personalizzati per i componenti aggiuntivi VSTO gestiti, anziché usare il caricatore del componente aggiuntivo VSTO (VSTOLoader.dll) e Strumenti di Visual Studio per il runtime di Office. Per altre informazioni, vedere Architecture of VSTO Add-ins.

Come vengono caricati i componenti aggiuntivi gestiti

All'avvio di un'applicazione vengono effettuate le operazioni seguenti:

  1. L'applicazione individua i componenti aggiuntivi VSTO cercando le voci nella chiave seguente del Registro di sistema:

    HKEY_CURRENT_Uedizione Standard R\Software\Microsoft\Office\<nome> applicazione\Addins\

    Ogni voce sotto questa chiave del Registro di sistema è un ID univoco del componente aggiuntivo VSTO. In genere, corrisponde al nome dell'assembly del componente aggiuntivo VSTO.

  2. L'applicazione cerca una voce Manifest nella voce per ciascun componente aggiuntivo VSTO.

    I componenti aggiuntivi VSTO gestiti possono archiviare il percorso completo di un manifesto nella voce in Manifest HKEY_CURRENT_Uedizione Standard R\Software\Microsoft\Office\<application name>\Addins\<add-in ID.> Un manifesto è un file (in genere, un file XML) che fornisce informazioni usate per consentire il caricamento del componente aggiuntivo VSTO.

  3. Se l'applicazione individua una voce Manifest , prova a caricare un componente caricatore per componenti aggiuntivi VSTO gestiti. L'applicazione esegue questa operazione provando a creare un oggetto COM che implementa l'interfaccia IManagedAddin.

    Il runtime di Strumenti di Visual Studio per Office include un componente del caricatore del componente aggiuntivo VSTO (VSTOLoader.dll) oppure è possibile crearne uno personalizzato implementando l'interfaccia IManagedAddin.

  4. L'applicazione chiama il metodo IManagedAddin::Load e passa il valore della voce Manifest .

  5. Il metodo IManagedAddin::Load esegue le attività necessarie per caricare il componente aggiuntivo VSTO, ad esempio la configurazione del dominio dell'applicazione e dei criteri di sicurezza per il componente aggiuntivo VSTO caricato.

    Per altre informazioni sulle chiavi del Registro di sistema usate da Microsoft app Office lications per individuare e caricare componenti aggiuntivi VSTO gestiti, vedere Voci del Registro di sistema per i componenti aggiuntivi VSTO.

Linee guida per implementare IManagedAddin

Se si implementa IManagedAddin, è necessario registrare la DLL che contiene l'implementazione usando il CLSID seguente:

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

Microsoft app Office lications usa questo CLSID per creare l'oggetto COM che implementa IManagedAddin.

Attenzione

Questo CLSID viene usato anche da VSTOLoader.dll nel Strumenti di Visual Studio per il runtime di Office. Pertanto, se si usa IManagedAddin per creare il proprio componente aggiuntivo VSTO e il componente di runtime, non è possibile distribuire il componente nei computer che eseguono componenti aggiuntivi VSTO che si basano sul Strumenti di Visual Studio per il runtime di Office.

Vedi anche