IManagedAddin – rozhraní

Článek
10/10/2023

Implementujte rozhraní IManagedAddin a vytvořte komponentu, která načítá spravované doplňky VSTO. Toto rozhraní bylo přidáno do systému systém Microsoft Office 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();
};

Metody

Následující tabulka uvádí metody definované rozhraním IManagedAddin.

Název	Popis
IManagedAddin::Load	Volá se, když aplikace systém Microsoft Office načte spravovaný doplněk VSTO.
IManagedAddin::Unload	Volá se těsně před tím, než systém Microsoft Office aplikace uvolní spravovaný doplněk VSTO.

Poznámky

systém Microsoft Office aplikace, počínaje systémem systém Microsoft Office 2007, používají rozhraní IManagedAddin k načtení doplňků Office VSTO. Můžete implementovat IManagedAddin rozhraní pro vytvoření vlastního zavaděče VSTO Add-in a modulu runtime pro spravované doplňky VSTO místo použití zavaděče VSTO Add-in (VSTOLoader.dll) a Visual Studio Tools for Office runtime . Další informace naleznete v tématu Architektura doplňků VSTO.

Jak se načítají spravované doplňky

Při spuštění aplikace dochází k následujícím krokům:

Aplikace vyhledá doplňky VSTO vyhledáním položek pod následujícím klíčem registru:

HKEY_CURRENT_USER\Software\Microsoft\Office\<název> aplikace\Addins\

Každá položka pod tímto klíčem registru je jedinečné ID doplňku VSTO. Obvykle se jedná o název sestavení doplňku VSTO.
Aplikace hledá položku pod položkou Manifest pro každý doplněk VSTO.

Spravované doplňky VSTO mohou v položce HKEY_CURRENT_USER\Software\Microsoft\Office\<application name>\Addins\<add-in ID> uložit úplnou cestu manifestu.Manifest Manifest je soubor (obvykle soubor XML), který poskytuje informace, které slouží k načtení doplňku VSTO.
Pokud aplikace najde Manifest položku, aplikace se pokusí načíst spravovanou komponentu zavaděče VSTO Add-in. Aplikace to provede pokusem vytvořit objekt COM, který implementuje IManagedAddin rozhraní.

Visual Studio Tools for Office runtime zahrnuje komponentu zavaděče VSTO (VSTOLoader.dll) nebo můžete vytvořit vlastní pomocí implementace rozhraní IManagedAddin.
Aplikace volá IManagedAddin::Load metoda a předává hodnotu Manifest položky.
Metoda IManagedAddin::Load provádí úlohy potřebné k načtení doplňku VSTO, například konfigurace domény aplikace a zásad zabezpečení pro doplněk VSTO, který se načítá.

Další informace o klíčích registru, které systém Microsoft Office aplikace používají ke zjišťování a načítání spravovaných doplňků VSTO, naleznete v tématu Položky registru pro doplňky VSTO.

Pokyny k implementaci IManagedAddin

Pokud implementujete IManagedAddin, musíte zaregistrovat knihovnu DLL, která obsahuje implementaci pomocí následujícího CLSID:

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

systém Microsoft Office aplikace používají tento CLSID k vytvoření objektu COM, který implementuje IManagedAddin.

Upozornění

Tento CLSID je také používán VSTOLoader.dll v sadě Visual Studio Tools for Office runtime . Proto pokud používáte IManagedAddin k vytvoření vlastní komponenty zavaděče VSTO a modulu runtime, nemůžete ji nasadit do počítačů, na kterých běží doplňky VSTO, které spoléhají na Visual Studio Tools for Office runtime .

Viz také

Referenční informace k nespravovanému rozhraní API (vývoj pro Office v sadě Visual Studio)

Sdílet prostřednictvím