Udostępnij za pośrednictwem

Debugowanie projektów pakietu Office

  • Artykuł

Projekty pakietu Office można debugować przy użyciu tych samych narzędzi programu Microsoft Visual Studio, których używasz w innych projektach programu Visual Studio. Funkcje debugera programu Visual Studio, takie jak możliwość wstawiania punktów przerwania i wyświetlania zmiennych w oknie Ustawienia lokalne , są również dostępne podczas debugowania projektów pakietu Office. Aby uzyskać więcej informacji na temat narzędzi debugowania programu Visual Studio, zobacz Debugowanie w programie Visual Studio.

Napiwek

Aby uprościć debugowanie, zamknij wszystkie otwarte wystąpienia aplikacja pakietu Office licacji przed skompilowaniem i debugowaniem.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu i projektów dodatków VSTO. Zobacz Funkcje dostępne według aplikacja pakietu Office lication i typu projektu.

Uwaga

Chcesz opracowywać rozwiązania, które rozszerzają środowisko pakietu Office na wiele platform? Zapoznaj się z nowym modelem dodatków pakietu Office. Dodatki pakietu Office mają niewielki rozmiar w porównaniu z dodatkami I rozwiązaniami VSTO i można je tworzyć przy użyciu niemal dowolnej technologii programowania internetowego, takiej jak HTML5, JavaScript, CSS3 i XML.

Uruchamianie i zatrzymywanie debugera

Możesz rozpocząć debugowanie projektu pakietu Office, tak jak rozpoczynasz debugowanie innych projektów programu Visual Studio; na przykład możesz nacisnąć klawisz F5 . Po rozpoczęciu debugowania projektu dodatku VSTO zostanie uruchomiony nowy proces docelowej aplikacja pakietu Office licacji i załadowany dodatek VSTO.

Po rozpoczęciu debugowania projektu na poziomie dokumentu dokument lub skoroszyt zostanie otwarty w nowym procesie programu Word lub Excel.

Po zatrzymaniu debugera debuger przerywa proces aplikacji nagle lub odłącza się, jeśli debuger jest ustawiony na odłączenie. Wszystkie inne dokumenty otwarte w zakończonym procesie aplikacja pakietu Office lication są również zamykane bez ostrzeżenia, a wszelkie niezapisane zmiany zostaną utracone. Może to obejmować wszystkie dokumenty lub skoroszyty, które są otwierane podczas działania debugera.

Zazwyczaj lepiej jest odłączyć proces przed zatrzymaniem debugera, aby można było zamknąć aplikacja pakietu Office licację w normalny sposób. Możesz również odłączyć się od procesu, jeśli nadal chcesz pracować z otwartym dokumentem lub arkuszem po zatrzymaniu debugera.

Jeśli debugujesz dostosowywanie na poziomie dokumentu dla programu Word, wielokrotnie zatrzymuje debuger i powoduje, że program Word zostanie nagle zamknięty, może prowadzić do uszkodzenia szablonu Normalny. W takim przypadku można usunąć uszkodzony szablon Normalny i zostanie automatycznie utworzony ponownie przy następnym otwarciu programu Word. Jednak wszystkie makra przechowywane w szablonie Normalny nie są tworzone ponownie.

Debugowanie dodatków pakietu Office 2013 VSTO przy użyciu pakietu Office 2013 lub Office 2016

Jeśli używasz programu Visual Studio 2015 i masz zainstalowane obok siebie obie wersje pakietu Office, program Visual Studio uruchamia pakiet Office 2016. Jeśli używasz programu Visual Studio 2013, program Visual Studio uruchamia pakiet Office 2013.

Jeśli chcesz debugować dodatek VSTO przy użyciu innej wersji pakietu Office (2013 lub 2016), otwórz plik Project Projektant, a następnie na karcie Debugowanie wybierz przycisk Uruchom program zewnętrzny. Następnie przejdź do lokalizacji odpowiedniego pliku wykonywalnego aplikacja pakietu Office lication.

Zachowanie F10 i F11

Podczas uruchamiania debugowania projektu pakietu Office język F10 i F11 nie mają takiego samego zachowania jak podczas uruchamiania debugowania innych projektów Visual Basic lub C#. W projektach Visual Basic lub C# debuger zatrzymuje się w funkcji main; w projektach pakietu Office program Visual Studio nie ma kontroli nad główną funkcją aplikacja pakietu Office lication. Jednak podczas debugowania język F10 i F11 mają takie same funkcje jak w projektach Visual Basic i C#.

Wyświetlanie wyjątków

Ze względu na sposób interakcji kodu zarządzanego z niezarządzanymi kodami program Visual Studio nie wyświetla błędów zgłaszanych przez aplikacja pakietu Office lication firmy Microsoft. Jeśli na przykład dodatek VSTO utworzony przy użyciu narzędzi deweloperskich pakietu Office w programie Visual Studio zgłasza wyjątek, aplikacja pakietu Office licacja firmy Microsoft będzie kontynuowana bez wyświetlania błędu. Aby wyświetlić te błędy, ustaw debuger, aby przerwał wyjątki środowiska uruchomieniowego języka wspólnego. Aby uzyskać więcej informacji, zobacz Zarządzanie wyjątkami za pomocą debugera.

Jeśli ustawisz debuger do przerwania wyjątków środowiska uruchomieniowego języka wspólnego, wszystkie wyjątki zostaną teraz podzielone na debuger, w tym te, które zostały obsłużone, i niektóre wyjątki pierwszej szansy z samego środowiska uruchomieniowego, które mogą nie być istotne dla projektu. Błędy odwołujące się do protokołu msosec nie są wyświetlane w każdym projekcie, ale są bezpieczne do zignorowania. Te wyjątki msosec nie będą mieć wpływu na Twoje rozwiązanie.

Możesz również użyć opcji Wypróbuj... Przechwyć instrukcje wokół metod przechwytywania wyjątków.

Domyślnie program Visual Studio nie wyświetla również błędów debugowania just in time dla projektów pakietu Office; Można jednak włączyć tę funkcję, aby zobaczyć zgłoszone błędy. Aby uzyskać więcej informacji, zobacz Debugowanie just in time w programie Visual Studio.

Argumenty wiersza polecenia

Jeśli na stronie właściwości Debugowanie jest ustawiona akcja uruchamiania projektu, program Visual Studio nie używa argumentów wiersza polecenia podczas debugowania projektu, nawet jeśli określono argumenty wiersza polecenia jako opcje uruchamiania. Jeśli chcesz użyć argumentów wiersza polecenia podczas uruchamiania debugowania, musisz wybrać akcję początkową inną niż Uruchom projekt.

Kontrola źródła

Właściwości debugowania nie są współużytkowane przez wielu użytkowników w ramach kontroli źródła. Projekty Visual Basic i C# przechowują właściwości debugowania w pliku specyficznym dla użytkownika (ProjectName.vbproj.user lub ProjectName.csproj.user), a ten plik nie jest pod kontrolą źródła. Jeśli debugowanie jest więcej niż jedna osoba, każda osoba musi ręcznie wprowadzić właściwości debugowania.

Debugowanie buforowanych zestawów danych w projekcie na poziomie dokumentu

Za każdym razem, gdy tworzysz projekt, zestaw danych jest opróżniany i ponownie utworzony. Jeśli chcesz debugować buforowany zestaw danych, musisz otworzyć dokument poza programem Visual Studio, a następnie dołączyć debuger.

Debugowanie projektów dokumentów programu Word na podstawie formatu dokumentu programu Word 97–2003 (*.doc)

Aby debugować projekt dokumentu programu Word w oparciu o format dokumentu programu Word 97-2003 (/doc*), należy dodać folder projektu do listy zaufanych folderów. Aby uzyskać więcej informacji na temat tego, jak to zrobić, zobacz Udzielanie zaufania do dokumentów.

Debugowanie wyłączonych dodatków

Microsoft aplikacja pakietu Office lications może wyłączyć dodatki VSTO, które zachowują się nieoczekiwanie. Aplikacja pakietu Office lication firmy Microsoft wyłącza dodatki VSTO, aby zapobiec ładowaniu problematycznego kodu za każdym razem, gdy aplikacja zostanie uruchomiona. Jednak podczas typowego debugowania można również łatwo spowodować nieoczekiwane zachowanie. Aby uzyskać informacje na temat ponownego włączania dodatków VSTO, zobacz Instrukcje: ponowne włączanie dodatku VSTO, który został wyłączony.

Istnieją dwa typy wyłączania, które są używane przez program Microsoft aplikacja pakietu Office lications w przypadku dodatków VSTO: wyłączenie twarde i wyłączenie nietrwałe.

Wyłączanie twarde

Wyłączenie twarde może wystąpić, gdy dodatek VSTO powoduje nieoczekiwane zamknięcie aplikacji. Może to również wystąpić na komputerze dewelopera, jeśli zatrzymasz debuger podczas Startup wykonywania programu obsługi zdarzeń w dodatku VSTO. Gdy dodatek VSTO jest wyłączony, zostanie wyświetlony na liście Elementy wyłączone w aplikacji.

Jeśli aplikacja pakietu Office lication hard wyłączy dodatek VSTO utworzony przy użyciu narzędzi programistycznych pakietu Office w programie Visual Studio, aplikacja wyłączy tylko dodatek VSTO, który spowodował awarię. Inne dodatki VSTO utworzone przy użyciu narzędzi programistycznych pakietu Office w programie Visual Studio dla tego aplikacja pakietu Office lication będą nadal ładowane.

Wyłączanie nietrwałe

Wyłączenie nietrwałe może wystąpić, gdy dodatek VSTO generuje błąd, który nie powoduje nieoczekiwanego zamknięcia aplikacji. Na przykład aplikacja może nietrwale wyłączyć dodatek VSTO, jeśli zgłasza nieobsługiwany wyjątek podczas Startup wykonywania programu obsługi zdarzeń. Gdy dodatek VSTO jest nietrwały wyłączony, pojawia się na liście Nieaktywne dodatki aplikacji w aplikacji, a aplikacja zmienia wartość wpisu rejestru LoadBehavior dla dodatku VSTO, aby wskazać, że został zwolniony. Aby uzyskać więcej informacji na temat wpisu rejestru LoadBehavior , zobacz Wpisy rejestru dla dodatków VSTO.

Rozwiązywanie problemów z błędami instalacji przy użyciu Podgląd zdarzeń

Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office zapisuje komunikaty do Podgląd zdarzeń w systemie Windows dla wszystkich wyjątków zgłaszanych podczas instalowania lub odinstalowywania rozwiązań pakietu Office. Te komunikaty umożliwiają rozwiązywanie problemów z instalacją i wdrażaniem.

Rozwiązywanie problemów z błędami uruchamiania przy użyciu pliku dziennika i komunikatów o błędach

Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office może zapisywać wszystkie błędy występujące podczas uruchamiania do pliku dziennika lub wyświetlać każdy błąd w polu komunikatu. Domyślnie te opcje są wyłączone. Opcje można włączyć, tworząc zmienne środowiskowe.

Aby wyświetlić każdy błąd w oknie komunikatu, utwórz zmienną środowiskową o nazwie VSTO_SUPPRESSDISPLAYALERTS i ustaw ją na 0 (zero). Komunikaty można pominąć, usuwając zmienną środowiskową lub ustawiając ją na 1 (jeden).

Aby zapisać błędy w pliku dziennika, utwórz zmienną środowiskową o nazwie VSTO_LOGALERTS i ustaw ją na 1 (jeden). Środowisko uruchomieniowe Visual Studio Tools dla pakietu Office tworzy plik dziennika w folderze zawierającym manifest wdrożenia dodatku VSTO lub w folderze zawierającym dokument lub skoroszyt skojarzony z dostosowaniem. Jeśli to się nie powiedzie, środowisko uruchomieniowe Visual Studio Tools dla pakietu Office utworzy plik dziennika w lokalnym folderze %TEMP%. W przypadku dodatków VSTO na poziomie aplikacji domyślna nazwa to add-in name.vsto.log. W przypadku projektów na poziomie dokumentu nazwa pliku dziennika to nazwa dokumentu.extension.log, na przykład ExcelWorkbook1.xlsx.log. Aby zatrzymać rejestrowanie błędów, usuń zmienną środowiskową lub ustaw ją na 0 (zero).

Powiązana zawartość