Sdílet prostřednictvím


Ladění projektů Office

Projekty Office lze ladit pomocí stejného Microsoft Visual Studio můžete použít pro jiné nástroje Visual Studio projektů.Visual StudioFunkce, například možnost vložení zarážky a zobrazení proměnných v ladicí program lokální okna, jsou také k dispozici při ladění projekty Office.Další informace o Visual Studio ladicí nástroje, viz Ladění v sadě Visual Studio.

Tip

Pro zjednodušení ladění, zavřete všechny otevřené instance aplikace systému Office, sestavení a ladění.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu i na úrovni aplikace v Office 2013 a v Office 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

odkaz na video Související video ukázku naleznete v tématu jak i ladění aplikace VSTO?.

Spuštění a zastavení ladicí program

Stejně jako ostatní ladění spustit ladění projektu aplikace sady Office můžete spustit Visual Studio projekty; Například můžete stisknutím klávesy F5.Při spuštění ladění aplikace úroveň doplněk projekt spuštěn nový proces pro cílovou aplikaci sady Office a je načten doplněk.Při spuštění ladění úrovni dokumentu projekt dokument nebo sešit otevře nový proces aplikace Word nebo Excel.

Při zastavení ladicí program ladicí program neočekávaného ukončení procesu aplikace nebo pokud máte ladicí program nastavit, chcete-li odpojit odpojí.Všechny dokumenty, které jsou otevřeny v procesu ukončení aplikace sady Office jsou také uzavřít bez předchozího upozornění a veškeré neuložené změny budou ztraceny.To může zahrnovat všechny dokumenty nebo sešity, které jsou otevřeny v době, kdy je spuštěn ladicí program.

Obvykle je lepší odpojit od procesu před zastavením ladicí program, tak, aby aplikace sady Office můžete ukončit běžným způsobem.Je možné odebrat z procesu nejprve Pokud chcete pracovat s otevřeného dokumentu nebo listu po zastavení ladicí program.

Jestliže ladíte přizpůsobení úrovni dokumentu aplikace Word, opakovaně zastavení ladicí program a způsobit tak náhle ukončení aplikace Word může vést k poškození šablony Normal.V takovém případě můžete odstranit poškozené šablony Normal a znovu ji bude automaticky vytvořen při příštím otevření aplikace Word.Však nejsou k opětovnému vytvoření makra, které byly uloženy v šabloně Normal.

F10 a F11 chování

Při spuštění ladění Office project F10 a F11 nemají stejné chování jako při spuštění ladění ostatních projektů jazyka Visual Basic nebo C#.V projektech aplikace Visual Basic nebo C# ladicí program zastaví na hlavní funkci. v projektech systému Office Visual Studio nemá kontrolu nad hlavní funkce aplikace sady Office.Ale během ladění, F10 a F11 mají stejné funkce jako projekty jazyka Visual Basic a C#.

Zobrazení výjimek

Díky způsobu, jakým spravovaného kódu pracuje s nespravovaným kódem Visual Studio nezobrazuje chyby, které jsou vyvolány pomocí aplikací Microsoft Office.Například pokud doplněk vytvořených pomocí nástroje Office vývoj v Visual Studio vyvolá výjimku, aplikace Microsoft Office pokračuje bez zobrazení chyby.Chcete-li zobrazit tyto chyby, nastavte debugger přerušit na výjimky modulu CLR.Další informace naleznete v tématu Postupy: Přerušení při vyvolání výjimky.

Pokud nastavíte debugger přerušit na výjimky modulu CLR, všechny výjimky bude nyní rozdělit na ladicí program, včetně ty, které jsou zpracovány a některé první možnost výjimky z modulu runtime, který nemusí být relevantní pro váš projekt.Chyby není odkazující na msosec byl nalezen se vyskytují v každém projektu, ale nejsou bezpečně ignorovat.Tyto výjimky msosec neovlivní vaše řešení.

Můžete také použít Try...Catch příkazy kolem vaší metody k zachycení výjimky.

Ve výchozím nastavení aplikace Visual Studio také nemá zobrazení Just-In-Time ladění chyb pro projekty Office; však můžete tuto funkci povolit, aby mohli zobrazit 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 Spustit akci na ladění stránka vlastnost nastavena na Spuštění projektu, Visual Studio nepoužívá argumenty příkazového řádku při ladění projektu, i když argumenty příkazového řádku zadané jako možnosti spuštění.Pokud chcete použít argumenty příkazového řádku při spuštění ladění, je nutné vybrat Spustit akci než Spuštění projektu.

Ovládací prvek zdroje

Ladění vlastností nejsou sdíleny mezi více uživateli, ve zdrojovém ovládacím prvku.Projekty jazyka Visual Basic a C# ladění vlastností uložit do souborů pro jednotlivé uživatele (ProjectName. vbproj.user nebo ProjectName. csproj.user), a tento soubor není ve správě zdrojů.Pokud ladění je více než jedna osoba, každý uživatel ručně zadat vlastnosti ladění.

Ladění datové sady uložené v mezipaměti v úrovni dokumentu projekt

Pokaždé, když sestavíte projekt, dataset se vyprázdní a znovu vytvořen.Pokud chcete ladit datové sady v mezipaměti, musíte otevřít dokument mimo sadu Visual Studio a potom připojit ladicí program.

Ladění aplikace Word dokument projekty založené na dokumentu aplikace Word 97-2003 (* .doc) formát

K ladění projektu dokument aplikace Word, na základě dokumentu aplikace Word 97-2003 (* .doc) formát, složku projektu je nutné přidat do seznamu důvěryhodných složek.Další informace o tomto postupu naleznete v tématu Udělení důvěry dokumentům...

Ladění zakázané doplňky

Aplikace sady Office můžete zakázat doplňky, které se chovají neočekávaně.Aplikace sady Microsoft Office zakáže doplňky Chcete-li zabránit načítání při každém spuštění aplikace problematického kódu.Také je však snadno způsobit neočekávané chování při typické ladění.Informace o opětovném povolení doplňků naleznete v tématu Postupy: Opětovné povolení zakázaného doplňku.

Existují dva typy zákaz používaný aplikací Microsoft Office pro doplňky: zakázání tvrdé a měkké vypnutí.

Zakázání pevný

Zákaz tvrdě může dojít, pokud doplněk způsobuje neočekávané ukončení aplikace.To může také dojít na vašem vývojovém počítači Pokud ukončíte ladicí program při Startup obslužnou rutinu události v doplněk spuštěn.Pokud doplněk není povoleno pevný, zobrazí se v Zakázané položky seznamu v aplikaci.

Je-li aplikace sady Office pevný zakáže doplněk vytvořených pomocí nástroje Office vývoj v Visual Studio, aplikace zakáže pouze doplněk, který chybu způsobil.Ostatní doplňky vytvořené pomocí vývojářských nástrojů sady Office v aplikaci Visual Studio pro aplikace sady Office bude pokračovat načíst.

Měkké vypnutí

Měkké vypnutí může dojít, pokud doplněk vytvoří chybu, která nezpůsobuje neočekávané ukončení aplikace.Například aplikace může soft zakázat v případě, že nastane neošetřenou výjimku při Startup je spuštění obslužné rutiny události.Pokud doplněk není povoleno měkké, zobrazí se v Doplňky aplikace neaktivní seznam do aplikace a aplikace změní hodnotu LoadBehavior položka registru pro doplněk k označení, že je uvolněn.Další informace o LoadBehavior položka registru naleznete v tématu Položky registru pro doplňky na úrovni aplikací.

Odstraňování potíží s chybami instalaci pomocí prohlížeče událostí

Visual Studio Tools for Office runtime Zapisuje zprávy do prohlížeče událostí v systému Windows pro všechny výjimky, které jsou vyvolány při instalaci nebo odinstalování sady Office solutions.Tyto zprávy můžete použít k řešení problémů nasazení a instalace.

Odstraňování potíží s chybami při spuštění pomocí souboru protokolu a chybové zprávy

Visual Studio Tools for Office runtime Lze zapsat všechny chyby, ke kterým dochází při spuštění do protokolového souboru nebo zobrazit každou chybu v okně se zprávou.Tyto možnosti jsou ve výchozím nastavení vypnuty.Volby můžete zapnout vytvořením proměnné prostředí.

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

Chcete-li zapsat chyby do souboru protokolu, vytvořit proměnnou prostředí s názvem VSTO_LOGALERTS a nastavte ji na hodnotu 1 (jedna).Visual Studio Tools for Office runtime Soubor protokolu vytvořen ve složce, která obsahuje manifest nasazení pro doplněk, nebo na složku obsahující dokument nebo sešit, který je spojen s vlastním nastavením.Pokud se nezdaří, Visual Studio Tools for Office runtime je soubor protokolu vytvořen ve složce místní složka % TEMP %.Pro aplikace úroveň doplňky, výchozí název je add-in name. vsto.log.Pro projekty na úrovni dokumentu, název souboru protokolu je document name.extension.log, například ExcelWorkbook1.xlsx.log.Chcete-li zastavit protokolování chyb, odstranit proměnnou prostředí nebo nastavena na hodnotu 0 (nula).

Viz také

Úkoly

Postupy: Opětovné povolení zakázaného doplňku

Další zdroje

Sestavování řešení pro systém Office

Programování doplňků na úrovni aplikace