Položky registru pro doplňky úroveň aplikace

Článek
03/04/2013

Je třeba vytvořit sadu položek registru při nasazení doplňky, které jsou vytvořeny pomocí Visual Studio 2012.Tyto klíče registru obsahují informace, které umožňuje zjišťovat a načíst doplněk aplikace Microsoft Office.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni aplikace v systému Microsoft Office 2013 a Microsoft Office 2010. Další informace naleznete v tématu Funkce aplikace Office a typ projektu.

Při vytváření projektu Visual Studio vytvoří tyto položky registru na vývojovém počítači, takže můžete snadno spustit nebo ladit doplněk.Pokud používáte ClickOnce nasazení tohoto doplňku, položky registru jsou automaticky vytvořen na počítači koncového uživatele.Používáte-li Instalační služba Windows Installer k instalaci tohoto doplňku, je nutné nakonfigurovat projekt InstallShield Limited Edition k vytvoření položky registru v počítači koncového uživatele.

Další informace o použití položky registru jsou v průběhu načítání doplňků naleznete v Architektura doplňků úroveň aplikace.

[!POZNÁMKA]

V tomto tématu, text ID doplněk představuje jedinečné ID pro daný doplněk.Výchozí ID je název vašeho sestavení doplněk.

Registrace doplňky pro aktuálního uživatele VS. všem uživatelům

Po instalaci doplňku lze registrovat dvěma způsoby:

Pro aktuálního uživatele (to znamená, že je k dispozici pouze pro uživatele, který se přihlásí do počítače při instalaci doplňku).V tomto případě položky registru jsou vytvořeny v klíči HKEY_CURRENT_USER.
Pro všechny uživatele (to znamená všechny uživatele, přihlášení do počítače můžete add-in).V tomto případě položky registru jsou vytvářeny pod klíčem HKEY_LOCAL_MACHINE.

Všechny doplňky, které vytvoříte pomocí Visual Studio 2012 lze zaregistrovat pro aktuálního uživatele.Doplňky však může být registrováno pro všechny uživatele pouze v určitých situacích.Tyto scénáře závisí na verzi Microsoft Office v počítači a jak doplněk byla nasazena.

Verze sady Microsoft Office

Microsoft Office 2010 a Microsoft Office 2013 aplikace může načíst doplňky, které jsou registrovány pod HKEY_LOCAL_MACHINE a HKEY_CURRENT_USER.

Načtení doplňků, které jsou registrovány pod klíčem HKEY_LOCAL_MACHINE, musí mít počítače balíček aktualizací nainstalován 976477.Další informace naleznete v tématu https://go.microsoft.com/fwlink/?LinkId=184923.

Typ nasazení

Pokud používáte ClickOnce nasazení doplněk, add-in lze registrovat pouze pro aktuálního uživatele.To je protože ClickOnce podporuje pouze vytváření klíče HKEY_CURRENT_USER.Pokud chcete zaregistrovat doplněk pro všechny uživatele v počítači, je nutné použít Instalační služba Windows Installer zavést doplněk.Další informace o těchto typech nasazení naleznete v tématu Nasazení řešení Office s použitím technologie ClickOnce a Nasazení řešení Office s použitím Instalační služby systému Windows.

Položky registru

Požadované doplněk položky registru jsou umístěny v následujícím klíči registru pro všechny aplikace s výjimkou aplikace Visio, kde kořenový HKEY_CURRENT_USER nebo HKEY_LOCAL_MACHINE.

Kořen\Software\Microsoft\Office\název aplikace\Addins\ID doplněk

Pro aplikaci Visio patří do položky registru následující klíč registru.

Kořen\Software\Microsoft\Visio\Addins\ID doplněk

V následující tabulce jsou uvedeny položky v tomto klíči registru.

Entry	Type	Value
Description	REG_SZ	Povinné.Stručný popis doplněk. Tento popis se zobrazí, když uživatel vybere doplněk v Doplňky podokně Možnosti dialogové okno v aplikaci Microsoft Office.
FriendlyName	REG_SZ	Povinné.Popisný název doplňku, který se zobrazí v Doplňky modelu COM dialogové okno v aplikaci Microsoft Office.Výchozí hodnota je identifikátor.
LoadBehavior	REG_DWORD	Povinné.Hodnota, která určuje, kdy se aplikace pokusí načíst doplněk a aktuální stav doplněk (naložené nebo vyložené). Ve výchozím nastavení tato položka nastavena na 3, který určuje, zda doplněk je načtena při spuštění.Další informace naleznete v tématu LoadBehavior hodnoty.
Manifest	REG_SZ	Povinné.Úplnou cestu k manifestu nasazení pro doplněk.Cesta může být umístění v místním počítači síťové sdílené položce (UNC) nebo webový server (HTTP). Používáte-li Instalační služba Windows Installer můžete nasadit řešení, je třeba přidat předponu file:/// se manifest cestu.Musíte také přidat řetězec \|vstolocal (to jest znakem\|Následuje vstolocal) na konci této cesty.Tím je zajištěno, že vaše řešení je načten z instalační složky namísto mezipaměti ClickOnce.Další informace naleznete v tématu Nasazení řešení Office s použitím Instalační služby systému Windows. Poznámka Když vytváříte doplněk na vývojovém počítači, aplikace Visual Studio automaticky připojí \|vstolocal řetězec s touto položkou registru.
Warmup	REG_DWORD	Nepovinné.Hodnota, která označuje, že rozhraní.NET Framework a Visual Studio Tools for Office runtime před načte doplněk načíst a zkrátit dobu vnímaných načíst doplněk.Nastavit Warmup položku na hodnotu 1 a jeho použití ve spojení s LoadBehavior položku, kterou chcete zkrátit dobu zatížení pro aplikaci Outlook 2010 a Outlook 2013 doplňky, které jsou nasazeny pomocí Instalační služba Windows Installer (MSI).Tento klíč registru nelze nastavit pomocí ClickOnce.

Položky registru pro oblasti formulářů aplikace Outlook

Pokud vytvoříte vlastní formulář oblast v doplňku pro aplikaci Outlook, další klíče registru slouží k evidenci oblast formuláře s aplikací Outlook.Tyto položky jsou vytvářeny pod klíčem registru pro každou třídu zpráv, který podporuje oblast formuláře.Jsou tyto klíče registru v následujícím umístění, kde kořenový HKEY_CURRENT_USER nebo HKEY_LOCAL_MACHINE.

Kořen\Software\Microsoft\Office\Outlook\FormRegions\Třída zprávy

Stejně jako ostatní položky registru sdíleny všechny doplňky aplikace Visual Studio vytvoří formulář položky registru regionu na vývojovém počítači při sestavení projektu.Pokud používáte ClickOnce nasazení tohoto doplňku, položky registru jsou automaticky vytvořen na počítači koncového uživatele.Používáte-li Instalační služba Windows Installer k instalaci tohoto doplňku, je nutné nakonfigurovat projekt InstallShield Limited Edition k vytvoření položky registru v počítači koncového uživatele.

Další informace o položkách registru oblast formuláře, viz Určení oblastí formulářů v registru systému Windows.Další informace o oblasti formulářů aplikace Outlook naleznete v tématu Vytvoření oblasti formulářů aplikace Outlook.

Hodnoty LoadBehavior

LoadBehavior Položku kořenový\Software\Microsoft\Office\název aplikace\Addins\ID add-in klíč obsahuje bitovou kombinaci hodnot, které určují chování běhu doplněk.Nejnižším bitem (hodnoty 0 a 1) označuje, zda doplněk je nyní uvolněna nebo načten.Ostatní bity označují, když aplikace pokusí načíst doplněk.

Obvykle LoadBehavior položka má být nastavena na 0, 3 nebo 16 (v desítkové soustavě) při doplněk je nainstalován v počítačích koncových uživatelů.Ve výchozím nastavení Visual Studio LoadBehavior vstupu doplněk 3 při vytváření nebo při publikování.

V následující tabulce jsou uvedeny všechny možné hodnoty LoadBehavior položka.Některé popisy v této tabulce naleznete načítání doplňku ručně nebo programově.Chcete-li ručně načíst doplněk, zaškrtněte políčko u doplňku v Doplňky modelu COM dialogové okno v aplikaci.Chcete-li programově načíst doplněk, nastavte Connect vlastnost COMAddIn objekt, který představuje doplněk k true.

Hodnota (desetinné číslo)	Stav	Chování při načítání doplňku	Description
0	Uvolnění	Automatické načtení	Nikdy aplikace se pokusí načíst doplněk automaticky.Uživatel může pokusit ručně načíst doplněk nebo doplněk lze načíst programově. Je-li doplněk úspěšně načten, LoadBehavior hodnota zůstává 0, ale stav doplněk v Doplňky modelu COM dialogové okno je aktualizován označíte, že doplněk je zaveden.
1	Načtení	Automatické načtení	Nikdy aplikace se pokusí načíst doplněk automaticky.Uživatel může pokusit ručně načíst doplněk nebo doplněk lze načíst programově. I když Doplňky modelu COM dialogové okno označuje, že doplněk načten po spuštění aplikace, doplněk není skutečně načten, dokud je načten, ručně nebo programově. Je-li žádost úspěšně načte doplněk, LoadBehavior hodnota se změní na hodnotu 0 a zůstává na 0, po zavření aplikace.
2	Uvolnění	Načíst při spuštění	Aplikace nebude pokoušet načíst doplněk automaticky.Uživatel může pokusit ručně načíst doplněk nebo doplněk lze načíst programově. Je-li žádost úspěšně načte doplněk, LoadBehavior hodnota se změní na 3 a 3 zůstane po zavření aplikace.
3	Načtení	Načíst při spuštění	Aplikace se pokusí načíst doplněk, při spuštění aplikace.Toto je výchozí hodnota při vytvoření nebo publikování doplněk v aplikaci Visual Studio. Je-li žádost úspěšně načte doplněk, LoadBehavior hodnota zůstává 3.Pokud dojde k chybě při načítání doplňku, LoadBehavior hodnota se změní na 2 a 2 zůstane po zavření aplikace.
8	Uvolnění	Načíst na požádání	Aplikace nebude pokoušet načíst doplněk automaticky.Uživatel může pokusit ručně načíst doplněk nebo doplněk lze načíst programově. Je-li žádost úspěšně načte doplněk, LoadBehavior hodnota se změní na 9.
9	Načtení	Načíst na požádání	Doplněk bude načten pouze v případě, že aplikace vyžaduje, například při kliknutí na prvek uživatelského rozhraní, která používá funkce v doplňku (například vlastní tlačítko na pásu karet). Je-li žádost úspěšně načte doplněk, LoadBehavior hodnota zůstává 9, ale stav doplněk v Doplňky modelu COM dialogové okno je aktualizován označíte, že add-in je aktuálně načtený.Pokud dojde k chybě při načítání doplňku, LoadBehavior hodnota se změní na 8.
16	Načtení	Při prvním načtení a potom načíst na požádání	Tuto hodnotu nastavte, pokud chcete doplněk načíst na požádání.Aplikace načte doplněk aplikace pro první spuštění uživatelem.Při příštím spuštění aplikace, aplikace načte všechny prvky uživatelského rozhraní, které jsou definovány pomocí doplňku, ale doplněk není načten až uživatel klepne na prvek uživatelského rozhraní, který je spojen s add-in. Při použití se úspěšně načte doplněk poprvé, LoadBehavior hodnota zůstává 16, když je načten doplněk.Po zavření aplikace LoadBehavior hodnota se změní na 9.