Položky registru pro doplňky na úrovni aplikací

Článek
05/16/2015

Je nutné vytvořit konkrétní sady položek registru, když nasadíte doplňků, které jsou vytvořeny pomocí Visual Studio 2013.Tyto položky 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 Microsoft Office 2013 a Microsoft Office 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

Při vytváření projektu sady Visual Studio vytvoří tyto položky registru na vývojovém počítači, takže můžete snadno spustit a ladit doplněk upthe.Pokud používáte ClickOnce pro nasazení tohoto doplňku, položky registru jsou automaticky vytvářeny v počítači koncového uživatele.Pokud použijete k nasazení tohoto doplňku Instalační služby systému Windows, je nutné nakonfigurovat projekt InstallShield Limited Edition vytvoření položky registru v počítači koncového uživatele.

Další informace o tom, jak se používají položky registru během procesu načtení pro doplňky, naleznete v části Architektura doplňků na úrovni aplikace.

[!POZNÁMKA]

V tomto tématu, text ID doplněk představuje jedinečné ID pro doplněk.Ve výchozím nastavení je ID název doplňku sestavení.

Registrace doplňky pro vs aktuálního uživatele.Všichni uživatelé

Pokud doplněk je nainstalován, 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í počítače při instalaci doplňku).V takovém případě položky registru jsou vytvářeny HKEY_CURRENT_USER.
Pro všechny uživatele (to znamená, že všechny uživatele, aby se přihlásí na počítači pomocí doplňku).V takovém případě položky registru jsou vytvářeny pod klíčem HKEY_LOCAL_MACHINE.

Všechny moduly, které vytvoříte pomocí Visual Studio 2013 lze registrovat 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 scénářů.Tyto scénáře, závisí na verzi sady Microsoft Office v počítači a jak nasazena doplňku.

Verze aplikace Microsoft Office

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

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

Typ nasazení

Pokud používáte ClickOnce k instalaci doplňku, doplňku lze registrovat pouze pro aktuálního uživatele.To je způsobeno ClickOnce podporuje pouze vytváření klíče HKEY_CURRENT_USER.Pokud chcete k registraci doplněk pro všechny uživatele v počítači, musíte použít instalační služby systému Windows k nasazení doplňku.Další informace o těchto typů nasazení, naleznete v části 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í klíč registru pro všechny aplikace s výjimkou aplikace Visio, kde kořenový je HKEY_CURRENT_USER nebo HKEY_LOCAL_MACHINE.

Všechny aplikace s výjimkou aplikace Visio

Verze systému Office	Konfigurační cesta
32bitová	Kořenový\Software\Microsoft\Office\název aplikace\Addins\ID doplněk
64bitová	Kořenový\Software\Wow6432Node\Microsoft\Office\název aplikace\Addins\ID doplněk

Visio

Verze systému Office	Konfigurační cesta
32bitová	Kořenový\Software\Microsoft\Visio\Addins\ID doplněk
64bitová	Kořenový\Software\Wow6432Node\Visio\Addins\ID doplněk

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

Položka	Typ	Hodnota
Description	REG_SZ	Požadováno.Stručný popis doplňku. Tento popis se zobrazí, když uživatel vybere doplněk v Add-Ins podokna Možnosti dialogové okno v aplikaci Microsoft Office.
FriendlyName	REG_SZ	Požadováno.Popisný název tohoto 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	Požadováno.Hodnota, která určuje, kdy se aplikace pokusí načíst doplněk a aktuální stav doplňku (načíst nebo odpojeno). Tato položka je ve výchozím nastavení, nastavena na hodnotu 3, který určuje, že doplněk je načtena při spuštění.Další informace naleznete v tématu LoadBehavior hodnoty. [!POZNÁMKA] Pokud uživatel zakáže doplňku, tato akce upraví LoadBehavior hodnotu v podregistru HKEY_CURRENT_USER.Pro každého uživatele, hodnota LoadBehavior hodnota v podregistru HKEY_CURRENT_USER potlačí výchozí LoadBehavior definované v podregistru HKEY_LOCAL_MACHINE.
Manifest	REG_SZ	Požadováno.Úplná cesta manifestu nasazení pro doplněk.Cesta může být umístění v místním počítači, síťové sdílené složce (UNC) nebo na webový server (HTTP). Pokud používáte Instalační služby systému Windows můžete nasadit řešení, je nutné přidat předponu file:/// k manifestu cestu.Rovněž musíte přidat řetězec \|vstolocal (to znamená, znakem\|Následuje vstolocal) za účelem této cesty.To zajistí, že vaše řešení je načten z instalační složky, nikoli 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, Visual Studio automaticky připojí \|vstolocal řetězec s touto položkou registru.

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

Pokud vytvoříte vlastního formuláře oblast v doplňku pro aplikaci Outlook, další registru položky se používají k registraci 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.Tyto klíče registru jsou v následujícím umístění, kde kořenový je HKEY_CURRENT_USER nebo HKEY_LOCAL_MACHINE.

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

Podobně jako ostatní položky registru sdíleny všechny doplňky, Visual Studio vytvoří formulář položky registru oblast na vývojovém počítači při vytváření vašeho projektu.Pokud používáte ClickOnce pro nasazení tohoto doplňku, položky registru jsou automaticky vytvářeny v počítači koncového uživatele.Pokud použijete k nasazení tohoto doplňku Instalační služby systému Windows, je nutné nakonfigurovat projekt InstallShield Limited Edition vytvoření položky registru v počítači koncového uživatele.

Další informace o položky registru oblast formuláře, naleznete v části Určení oblasti formulářů v registru systému Windows.Další informace o oblasti formulářů aplikace Outlook, naleznete v části Vytváření oblastí formulářů aplikace Outlook.

LoadBehavior hodnoty

LoadBehavior Položku kořenový\Software\Microsoft\Office\název aplikace\Addins\ID doplněk klíč obsahuje bitová kombinace hodnot, které určují chování běhu doplňku.Nejnižší bit pořadí (hodnoty 0 a 1) označuje, zda doplňku je aktuálně odpojeno nebo načíst.Ostatní bity signalizují, že se aplikace pokusí načíst doplněk.

Obvykle LoadBehavior položka má být nastavena na hodnotu 0, 3 nebo 16 (v desetinné číslo) při doplňku instalaci do počítačů koncových uživatelů.Ve výchozím nastavení sady Visual Studio LoadBehavior vstupu tohoto doplňku 3 při vytváření nebo při publikování.

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

Hodnota (v desetinné číslo)	Doplněk stav	Načtení doplňku chování	Popis
0	uvolněné	Nebudou načteny automaticky	Nikdy se aplikace snaží načíst doplněk automaticky.Může uživatel provést ručně načíst doplněk nebo doplňku mohou být načteny programově. Pokud je doplněk úspěšně načten, LoadBehavior hodnota zůstane 0, ale stav doplněk v Doplňky modelu COM dialogového okna se aktualizuje označuje, že doplňku bude načten.
1	načteno	Nebudou načteny automaticky	Nikdy se aplikace snaží načíst doplněk automaticky.Může uživatel provést ručně načíst doplněk nebo doplňku mohou být načteny programově. I když Doplňky modelu COM dialogové okno označuje, že doplněk je načten po spuštění aplikace, doplňku není ve skutečnosti načíst dokud nebude vložen ručně nebo programově. Pokud aplikace úspěšně doplňku, načte LoadBehavior hodnota se změní na 0 a zůstává na 0 po ukončení aplikace.
2	uvolněné	Načíst při spuštění	Aplikace se nepokouší načíst doplněk automaticky.Může uživatel provést ručně načíst doplněk nebo doplňku mohou být načteny programově. Pokud aplikace úspěšně doplňku, načte LoadBehavior hodnota se změní na 3 a zůstává na 3 po ukončení aplikace.
3	načteno	Načíst při spuštění	Aplikace se snaží načíst doplněk při spuštění aplikace.Toto je výchozí hodnota při vytváření nebo publikování doplněk v sadě Visual Studio. Pokud aplikace úspěšně doplňku, načte LoadBehavior hodnota zůstane 3.Pokud dojde k chybě při načítání doplňku, LoadBehavior hodnota se změní na 2 a zůstává na 2 po ukončení aplikace.
8	uvolněné	Načíst na požádání	Aplikace se nepokouší načíst doplněk automaticky.Může uživatel provést ručně načíst doplněk nebo doplňku mohou být načteny programově. Pokud aplikace úspěšně doplňku, načte LoadBehavior hodnota se změní na 9.
9	načteno	Načíst na požádání	Doplněk bude načten pouze v případě, že aplikace vyžaduje, jako je například když uživatel klikne na prvek uživatelského rozhraní, který používá funkce add-in (například vlastní tlačítko na pásu karet). Pokud aplikace úspěšně načte doplněk, LoadBehavior hodnota zůstane 9, ale stav doplněk v Doplňky modelu COM dialogového okna se aktualizuje označuje, že doplněk je aktuálně zaveden.Pokud dojde k chybě při načítání doplňku, LoadBehavior hodnota se změní na 8.
16	načteno	První doba načítání a poté načíst na požádání	Tuto hodnotu nastavte, pokud chcete, aby doplněk mají být načtena na vyžádání.Když uživatel spustí aplikaci pro první načtení doplňku aplikace.Při příštím spuštění aplikace, aplikace načte všechny prvky uživatelského rozhraní, které jsou definovány doplňku, ale doplněk není načtou, dokud se uživatel klikne na prvek uživatelského rozhraní, který je přidružen k doplňku. Když se aplikace se úspěšně načte doplněk poprvé, LoadBehavior hodnota zůstane 16 načítání doplňku.Po ukončení aplikace, LoadBehavior hodnota se změní na 9.