Sdílet prostřednictvím

Ladění projektů Office

  • Článek

Projekty Office můžete ladit pomocí stejných nástrojů sady Microsoft Visual Studio, které používáte pro jiné projekty sady Visual Studio. Funkce ladicího programu sady Visual Studio, například možnost vkládat zarážky a zobrazit proměnné v okně Místní hodnoty, jsou také k dispozici při ladění projektů Office. Další informace o nástrojích ladění sady Visual Studio naleznete v tématu Ladění v sadě Visual Studio.

Tip

Pokud chcete zjednodušit ladění, zavřete před sestavením a laděním všechny otevřené instance aplikace Office lication.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentu a projekty doplňků VSTO. Viz Funkce dostupné podle typu aplikace Office lication a 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.

Spuštění a zastavení ladicího programu

Ladění projektu Office můžete spustit stejně jako začít ladit jiné projekty sady Visual Studio; Můžete například stisknout klávesu F5 . Když spustíte ladění projektu doplňku VSTO, spustí se nový proces cílové aplikace Office licace a načte se doplněk VSTO.

Když začnete ladit projekt na úrovni dokumentu, dokument nebo sešit se otevře v novém procesu aplikace Word nebo Excel.

Když ladicí program zastavíte, ladicí program náhle ukončí proces aplikace nebo odpojí, pokud máte ladicí program nastavený na odpojení. Všechny ostatní dokumenty, které jsou otevřeny v ukončené aplikace Office lication procesu, jsou také uzavřeny bez upozornění a všechny neuložené změny budou ztraceny. To může zahrnovat všechny dokumenty nebo sešity, které jsou otevřeny při spuštění ladicího programu.

Obvykle je lepší odpojit od procesu před zastavením ladicího programu, abyste mohli ukončit aplikace Office licaci běžným způsobem. Pokud chcete i po zastavení ladicího programu pracovat s otevřeným dokumentem nebo listem, můžete se nejprve od procesu odpojit.

Pokud ladíte vlastní nastavení na úrovni dokumentu pro Word, může opakované zastavení ladicího programu a náhlé ukončení aplikace Word vést k poškození šablony Normal. Pokud k tomu dojde, můžete poškozenou šablonu Normal odstranit a při příštím otevření Wordu se automaticky znovu vytvoří. Všechna makra uložená v šabloně Normal se však znovu nevytvoří.

Ladění doplňků VSTO pro Office 2013 pomocí Office 2013 nebo Office 2016

Pokud používáte Visual Studio 2015 a máte nainstalované obě verze Office vedle sebe, Visual Studio spustí Office 2016. Pokud používáte Visual Studio 2013, Visual Studio spustí Office 2013.

Pokud chcete doplněk VSTO ladit pomocí jiné verze Office (2013 nebo 2016), otevřete Návrháře projektů a na kartě Ladění zvolte tlačítko Spustit externí program . Pak přejděte do umístění příslušného spustitelného souboru aplikace Office lication.

Chování F10 a F11

Když spustíte ladění projektu Office, F10 a F11 nemají stejné chování jako při spuštění ladění jiných projektů Jazyka Visual Basic nebo C#. V projektech jazyka Visual Basic nebo C# se ladicí program zastaví u hlavní funkce; v projektech Office nemá Visual Studio kontrolu nad hlavní funkcí aplikace Office lication. Během ladění ale F10 a F11 mají stejné funkce jako v projektech Jazyka Visual Basic a C#.

Zobrazení výjimek

Vzhledem ke způsobu, jakým spravovaný kód komunikuje s nespravovaným kódem, Visual Studio nezobrazuje chyby, které jsou vyvolány systém Microsoft Office aplikacemi. Pokud například doplněk VSTO vytvořený pomocí vývojových nástrojů Office v sadě Visual Studio vyvolá výjimku, aplikace systém Microsoft Office pokračuje bez zobrazení chyby. Pokud chcete zobrazit tyto chyby, nastavte ladicí program tak, aby se přerušil u výjimek modulu CLR (Common Language Runtime). Další informace naleznete v tématu Správa výjimek pomocí ladicího programu.

Pokud ladicí program nastavíte tak, aby se přerušil u výjimek modulu CLR (Common Language Runtime), všechny výjimky se teď rozdělí do ladicího programu, včetně těch, které jste zpracovali, a některých výjimek s první šancí z samotného modulu runtime, které nemusí být pro váš projekt relevantní. Chyby odkazující na msosec se nezobrazují v každém projektu, ale je bezpečné je ignorovat. Tyto výjimky msosec nebudou mít vliv na vaše řešení.

Můžete také použít try ... Zachyťte příkazy kolem metod pro zachycení výjimek.

Ve výchozím nastavení sada Visual Studio také nezobrazuje chyby ladění za běhu pro projekty Office; Tuto funkci však můžete povolit, abyste viděli chyby, které jsou vyvolány. Další informace naleznete v tématu Ladění za běhu v sadě Visual Studio.

Argumenty příkazového řádku

Pokud je akce Spuštění na stránce vlastnosti Ladění nastavena na Spustit projekt, Visual Studio při ladění projektu nepoužívá argumenty příkazového řádku, i když jste jako možnosti spuštění zadali argumenty příkazového řádku. Pokud chcete při spuštění ladění použít argumenty příkazového řádku, musíte vybrat jinou akci spuštění než Spustit projekt.

Zdrojový ovládací prvek

Vlastnosti ladění nejsou sdíleny mezi více uživateli ve správě zdrojového kódu. Projekty Jazyka Visual Basic a C# ukládají vlastnosti ladění do souboru specifického pro uživatele (ProjectName.vbproj.user nebo ProjectName.csproj.user) a tento soubor není pod správou zdrojového kódu. Pokud ladění provádí více než jedna osoba, musí každá osoba zadat vlastnosti ladění ručně.

Ladění datových sad uložených v mezipaměti v projektu na úrovni dokumentu

Při každém sestavení projektu se datová sada vyprázdní a znovu vytvoří. Pokud chcete ladit datovou sadu uloženou v mezipaměti, musíte dokument otevřít mimo Visual Studio a pak připojit ladicí program.

Ladění projektů dokumentů aplikace Word na základě formátu dokumentu aplikace Word 97–2003 (*.doc)

Chcete-li ladit projekt dokumentu aplikace Word na základě formátu dokumentu aplikace Word 97–2003 (/.doc*), je nutné přidat složku projektu do seznamu důvěryhodných složek. Další informace o tom, jak to udělat, najdete v tématu Udělení důvěryhodnosti dokumentům.

Ladění zakázaných doplňků

systém Microsoft Office aplikace můžou zakázat doplňky VSTO, které se neočekávaně chovají. Aplikace systém Microsoft Office zakáže doplňky VSTO, aby se zabránilo problematickému načítání kódu při každém spuštění aplikace. Je ale také snadné způsobit neočekávané chování během typického ladění. Informace o opětovném povolení doplňků VSTO najdete v tématu Postupy: Opětovné povolení doplňku VSTO, který byl zakázán.

Existují dva typy zakázání, které systém Microsoft Office aplikace používají pro doplňky VSTO: pevné zakázání a obnovitelné zakázání.

Pevné zakázání

K pevnému zakázání může dojít, když doplněk VSTO způsobí neočekávaně zavření aplikace. Může k němu také dojít ve vývojovém počítači, pokud zastavíte ladicí program, zatímco obslužná rutina Startup události v doplňku VSTO se spouští. Pokud je doplněk VSTO zakázaný, zobrazí se v seznamu Zakázané položky v aplikaci.

Pokud aplikace Office lication pevně zakáže doplněk VSTO vytvořený pomocí vývojových nástrojů Office v sadě Visual Studio, aplikace zakáže pouze doplněk VSTO, který způsobil selhání. Další doplňky VSTO vytvořené pomocí vývojových nástrojů Office v sadě Visual Studio pro tento aplikace Office lication se budou dál načítat.

Obnovitelné zakázání

K obnovitelnému zakázání může dojít v případě, že doplněk VSTO způsobí neočekávaně zavření aplikace. Aplikace může například zakázat doplněk VSTO, pokud při provádění obslužné rutiny události vyvolá neošetřenou výjimku Startup . Pokud je doplněk VSTO zakázaný, zobrazí se v seznamu Neaktivní doplňky aplikace v aplikaci a aplikace změní hodnotu položky registru LoadBehavior pro doplněk VSTO, aby bylo možné indikovat, že je uvolněna. Další informace o položce registru LoadBehavior naleznete v tématu Položky registru pro doplňky VSTO.

Řešení chyb instalace pomocí Prohlížeč událostí

Visual Studio Tools for Office runtime zapisuje zprávy do Prohlížeč událostí ve Windows pro všechny výjimky, které jsou vyvolány při instalaci nebo odinstalaci řešení Office. Tyto zprávy můžete použít k řešení problémů s instalací a nasazením.

Řešení chyb při spuštění pomocí souboru protokolu a chybových zpráv

Visual Studio Tools for Office runtime může zapsat všechny chyby, ke kterým dochází při spuštění do souboru protokolu, nebo zobrazit každou chybu v okně se zprávou. Ve výchozím nastavení jsou tyto možnosti vypnuté. Možnosti můžete zapnout vytvořením proměnných prostředí.

Pokud chcete zobrazit každou chybu v poli se zprávou, vytvořte proměnnou prostředí s názvem VSTO_SUPPRESSDISPLAYALERTS a nastavte ji na 0 (nula). Zprávy můžete potlačit odstraněním proměnné prostředí nebo nastavením na hodnotu 1 (jedna).

Pokud chcete zapsat chyby do souboru protokolu, vytvořte proměnnou prostředí s názvem VSTO_LOGALERTS a nastavte ji na 1 (jednu). Visual Studio Tools for Office runtime vytvoří soubor protokolu ve složce, která obsahuje manifest nasazení doplňku VSTO, nebo ve složce, která obsahuje dokument nebo sešit přidružený k přizpůsobení. Pokud se to nezdaří, Visual Studio Tools for Office runtime vytvoří soubor protokolu v místní složce %TEMP% . Pro doplňky VSTO na úrovni aplikace je výchozím názvem název doplňku name.vsto.log. Pro projekty na úrovni dokumentu je název souboru protokolu název dokumentu.extension.log, například ExcelWorkbook1.xlsx.log. Pokud chcete zastavit chyby protokolování, odstraňte proměnnou prostředí nebo ji nastavte na 0 (nula).

Související obsah