Položky registru pro doplňky VSTO
Při nasazování doplňků VSTO vytvořených pomocí sady Visual Studio musíte vytvořit konkrétní sadu položek registru. Tyto položky registru poskytují informace, které aplikaci systém Microsoft Office umožňují zjistit a načíst doplněk VSTO.
Platí pro: Informace v tomto tématu platí pro projekty doplňků VSTO. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.
Poznámka:
Zajímá vás vývoj řešení, která rozšiřují prostředí Office napříč několika platformami? Podívejte se na nový model doplňků pro Office. Doplňky pro Office mají v porovnání s doplňky a řešeními VSTO malé nároky a můžete je vytvářet pomocí téměř jakékoli webové programovací technologie, jako je HTML5, JavaScript, CSS3 a XML.
Při sestavování projektu vytvoří Visual Studio tyto položky registru na vývojovém počítači. To vám pomůže snadno spouštět a ladit doplněk VSTO. Pomocí ClickOnce nasadíte doplněk VSTO, položky registru se automaticky vytvoří na počítači koncového uživatele.
Další informace o nasazení řešení VSTO pomocí Instalační služby systému Windows naleznete v tématu Nasazení řešení VSTO pomocí Instalační služby systému Windows.
Další informace o tom, jak se položky registru používají během procesu načítání doplňků VSTO, naleznete v tématu Architektura doplňků VSTO.
Poznámka:
V tomto tématu představuje ID textového doplňku jedinečné ID doplňku VSTO. Ve výchozím nastavení je ID název sestavení doplňku VSTO.
Registrace doplňků VSTO pro aktuálního uživatele a všechny uživatele
Když je doplněk VSTO nainstalovaný, můžete ho zaregistrovat dvěma způsoby:
Pouze pro aktuálního uživatele (Doplněk VSTO je k dispozici pouze uživateli, který byl přihlášen k počítači při instalaci doplňku). V tomto případě se položky registru vytvoří v rámci HKEY_CURRENT_USER.
Pro všechny uživatele (to znamená, že každý uživatel, který se přihlásí k počítači, může použít doplněk VSTO). V tomto případě se položky registru vytvoří v rámci HKEY_LOCAL_MACHINE.
Všechny doplňky VSTO, které vytvoříte pomocí sady Visual Studio, je možné zaregistrovat pro aktuálního uživatele. Doplňky VSTO se ale dají zaregistrovat pro všechny uživatele jenom v určitých scénářích. Tyto scénáře závisí na verzi systém Microsoft Office na počítači a na tom, jak byl doplněk VSTO nasazený.
Typ nasazení
Pokud k nasazení doplňku VSTO použijete ClickOnce, je možné doplněk VSTO zaregistrovat pouze pro aktuálního uživatele. Důvodem je to, že ClickOnce podporuje pouze vytváření klíčů v HKEY_CURRENT_USER. Pokud chcete zaregistrovat doplněk VSTO všem uživatelům v počítači, musíte k nasazení doplňku VSTO použít Instalační službu systému Windows. Další informace o těchto typech nasazení naleznete v tématu Nasazení řešení Office pomocí ClickOnce a Nasazení řešení Office pomocí Instalační služby systému Windows.
Položky registru
Požadované položky registru doplňku VSTO se nacházejí pod následujícími klíči registru, kde je kořenový adresář HKEY_CURRENT_USER nebo HKEY_LOCAL_MACHINE v závislosti na tom, jestli je instalace pro aktuálního uživatele nebo všechny uživatele.
| Aplikace Office | Cesta konfigurace |
|---|---|
| Visio | Root\Software\Microsoft\Visio\Addins\add-in ID |
| Všechny ostatní | Root\Software\Microsoft\Office\aplikace Office lication name\Addins\add-in ID |
Poznámka:
Pokud instalační program cílí na všechny uživatele v 64bitovém systému Windows, doporučuje se, aby obsahoval dvě položky registru, jednu pod HKEY_LOCAL_MACHINE\Software\Microsoft a jednu pod HKEY_LOCAL_MACHINE\Software\WOW6432Node\Microsoft hive. Je to proto, že uživatelé můžou na počítači používat 32bitovou nebo 64bitovou verzi Office.
Pokud instalační program cílí na aktuálního uživatele, není nutné instalovat na wow6432Node, protože HKEY_CURRENT_USER\Software cesta je sdílena.
Další informace najdete v tématu 32bitová a 64bitová data aplikace v registru.
Následující tabulka uvádí položky pod tímto klíčem registru.
| Položka | Typ | Hodnota |
|---|---|---|
| Popis | REG_SZ | Povinný: Stručný popis doplňku VSTO Tento popis se zobrazí, když uživatel vybere doplněk VSTO v podokně Doplňky v dialogovém okně Možnosti v aplikaci systém Microsoft Office. |
| Friendlyname | REG_SZ | Povinný: Popisný název doplňku VSTO, který se zobrazí v dialogovém okně Doplňky modelu COM v aplikaci systém Microsoft Office. Výchozí hodnota je ID doplňku VSTO. |
| LoadBehavior | REG_DWORD | Povinný: Hodnota, která určuje, kdy se aplikace pokusí načíst doplněk VSTO a aktuální stav doplňku VSTO (načteno nebo uvolněno). Ve výchozím nastavení je tato položka nastavená na hodnotu 3, která určuje, že se doplněk VSTO načte při spuštění. Další informace naleznete v tématu LoadBehavior hodnoty. Poznámka: Pokud uživatel zakáže doplněk VSTO, tato akce upraví hodnotu LoadBehavior v podregistru HKEY_CURRENT_USER registru. Pro každého uživatele hodnota LoadBehavior v HKEY_CURRENT_USER hive přepíše výchozí LoadBehavior definovaný v HKEY_LOCAL_MACHINE podregistru. |
| Manifestu | REG_SZ | Povinný: Úplná cesta manifestu nasazení pro doplněk VSTO. Cesta může být umístění na místním počítači, sdílené síťové složce (UNC) nebo webovém serveru (HTTP). Pokud k nasazení řešení použijete Instalační službu systému Windows, musíte do cesty manifestu přidat předponu file:///. Na konec této cesty musíte také připojit řetězec |vstolocal (tj. znak kanálu následovaný vstolocal|). Tím zajistíte, že se vaše řešení načte z instalační složky, nikoli z mezipaměti ClickOnce. Další informace naleznete v tématu Nasazení řešení Office pomocí Instalační služby systému Windows. Poznámka: Při vytváření doplňku VSTO na vývojovém počítači visual Studio automaticky připojí k této položce registru řetězec |vstolocal . |
Položky registru pro oblasti formulářů Aplikace Outlook
Pokud v doplňku VSTO pro Outlook vytvoříte vlastní oblast formuláře, použijí se další položky registru k registraci oblasti formuláře v Outlooku. Tyto položky jsou vytvořeny pod jiným klíčem registru pro každou třídu zpráv, kterou oblast formuláře podporuje. Tyto klíče registru jsou v následujícím umístění, kde je kořen HKEY_CURRENT_USER nebo HKEY_LOCAL_MACHINE.
Root\Software\Microsoft\Office\Outlook\FormRegions\message – třída
Stejně jako ostatní položky registru sdílené všemi doplňky VSTO, Visual Studio vytvoří položky registru oblastí formuláře na vývojovém počítači při sestavování projektu. Pomocí ClickOnce nasadíte doplněk VSTO, položky registru se automaticky vytvoří na počítači koncového uživatele. Pokud k nasazení doplňku VSTO použijete Instalační službu systému Windows, je nutné nakonfigurovat projekt InstallShield Limited Edition pro vytvoření položek registru na počítači koncového uživatele.
Další informace o položkách registru oblasti formuláře naleznete v tématu Určení umístění oblasti formuláře ve vlastním formuláři. Další informace o oblastech formulářů aplikace Outlook naleznete v tématu Vytvoření oblastí formuláře aplikace Outlook.
Hodnoty LoadBehavior
Položka LoadBehavior v kořenovém adresáři\Software\Microsoft\Office\název aplikace\Addins\add-in ID klíč obsahuje bitové kombinace hodnot, které určují chování běhu doplňku VSTO. Nejnižší bit pořadí (hodnoty 0 a 1) označuje, jestli je doplněk VSTO aktuálně uvolněný nebo načtený. Další bity indikují, kdy se aplikace pokusí načíst doplněk VSTO.
Položka LoadBehavior je obvykle nastavena na hodnotu 0, 3 nebo 16 (v desítkové soustavě), když je doplněk VSTO nainstalovaný na počítačích koncových uživatelů. Visual Studio ve výchozím nastavení nastaví položku LoadBehavior doplňku VSTO na 3, když ho sestavíte nebo publikujete.
V následující tabulce jsou uvedeny všechny možné hodnoty položky LoadBehavior . Některé popisy v této tabulce odkazují na ruční nebo programové načtení doplňku VSTO. Pokud chcete doplněk VSTO načíst ručně, zaškrtněte políčko vedle doplňku VSTO v dialogovém okně Doplňky modelu COM v aplikaci. Chcete-li načíst doplněk VSTO programově, nastavte Connect vlastnost COMAddIn objektu, který představuje doplněk VSTO na true.
| Hodnota (v desítkové soustavě) | Stav doplňku VSTO | Chování při načítání doplňku VSTO | Popis |
|---|---|---|---|
| 0 | uvolněné | Nenačítat automaticky | Aplikace se nikdy nepokusí načíst doplněk VSTO automaticky. Uživatel se může pokusit ručně načíst doplněk VSTO nebo je možné doplněk VSTO načíst programově. Pokud je doplněk VSTO úspěšně načtený, hodnota LoadBehavior zůstane 0, ale stav doplňku VSTO v dialogovém okně Doplňky modelu COM se aktualizuje tak, aby indikoval, že je načten doplněk VSTO. |
| 0 | Načten | Nenačítat automaticky | Aplikace se nikdy nepokusí načíst doplněk VSTO automaticky. Uživatel se může pokusit ručně načíst doplněk VSTO nebo je možné doplněk VSTO načíst programově. I když dialogové okno doplňky modelu COM indikuje, že se doplněk VSTO načte po spuštění aplikace, doplněk VSTO se nenačte, dokud se nenačte ručně nebo programově. Pokud aplikace úspěšně načte doplněk VSTO, hodnota LoadBehavior se změní na 0 a zůstane po zavření aplikace na 0. |
| 2 | uvolněné | Načtení při spuštění | Aplikace se nepokouší načíst doplněk VSTO automaticky. Uživatel se může pokusit ručně načíst doplněk VSTO nebo je možné doplněk VSTO načíst programově. Pokud aplikace úspěšně načte doplněk VSTO, hodnota LoadBehavior se změní na 3 a zůstane na 3 po zavření aplikace. |
| 3 | Načten | Načtení při spuštění | Aplikace se pokusí načíst doplněk VSTO při spuštění aplikace. Toto je výchozí hodnota při sestavování nebo publikování doplňku VSTO v sadě Visual Studio. Pokud aplikace úspěšně načte doplněk VSTO, hodnota LoadBehavior zůstane 3. Pokud při načítání doplňku VSTO dojde k chybě, hodnota LoadBehavior se změní na 2 a po zavření aplikace zůstane na 2. |
| 8 | uvolněné | Zatížení na vyžádání | Aplikace se nepokouší načíst doplněk VSTO automaticky. Uživatel se může pokusit ručně načíst doplněk VSTO nebo je možné doplněk VSTO načíst programově. Pokud aplikace úspěšně načte doplněk VSTO, hodnota LoadBehavior se změní na 9. |
| 9 | Načten | Zatížení na vyžádání | Doplněk VSTO se načte jenom v případech, kdy ji aplikace vyžaduje. Například když uživatel vybere prvek uživatelského rozhraní, který používá funkce v doplňku VSTO (například vlastní tlačítko na pásu karet). Pokud aplikace úspěšně načte doplněk VSTO, hodnota LoadBehavior zůstane 9, ale stav doplňku VSTO v dialogovém okně Doplňky modelu COM se aktualizuje tak, aby indikoval, že je doplněk VSTO právě načtený. Pokud při načítání doplňku VSTO dojde k chybě, hodnota LoadBehavior se změní na 8. |
| 16 | Načten | První načtení a následné načtení na vyžádání | Tuto hodnotu nastavte, pokud chcete, aby se doplněk VSTO načetl na vyžádání. Aplikace načte doplněk VSTO při prvním spuštění aplikace uživatelem. Při příštím spuštění aplikace aplikace aplikace načte všechny prvky uživatelského rozhraní definované doplňkem VSTO. Doplněk VSTO se ale nenačte, dokud uživatel nevybere prvek uživatelského rozhraní, který je přidružený k doplňku VSTO. Když aplikace poprvé úspěšně načte doplněk VSTO, hodnota LoadBehavior zůstane při načtení doplňku VSTO 16. Po zavření aplikace se hodnota LoadBehavior změní na 9. |