Debugowanie projektów pakietu Office

Biuro projektów można debugować za pomocą tej samej firmy Microsoft Visual Studio narzędzia użyć dla innych Visual Studio projektów.Visual StudioDebuger funkcji, takich jak wstawianie punkty przerwania i wyświetlić zmienne w mieszkańców okno, które zostały również podczas debugowania projektach dla pakietu Office.Aby uzyskać więcej informacji o Visual Studio narzędzia debugowania, zobacz Debugowania w środowisku Visual Studio.

Porada
Aby uprościć debugowania, zamknij wszystkie wystąpienia aplikacji pakietu Office, zanim budować i Debuguj je.

Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na poziomie dokumentu i projektów na poziomie aplikacji dla pakietu Office 2013 i Office 2010. Zobacz Funkcje dostępne w aplikacji pakietu Office i typ projektu.

Aby wyświetlić pokrewne wideo demonstracyjne, zobacz jak I: debugowania aplikacji VSTO?.

Uruchamianie i zatrzymywanie debugera

Można rozpocząć debugowanie projektu programu pakietu Office, tak, jak można rozpocząć debugowanie innych Visual Studio projektów; na przykład można nacisnąć klawisz F5.Podczas uruchamiania debugowania na poziomie aplikacji w projekcie nowego procesu dla docelowej aplikacji pakietu Office jest uruchomiony i jest ładowany dodatek.Podczas uruchamiania debugowania projekt na poziomie dokumentu, dokument lub skoroszyt zostanie otwarty w nowy proces programu Word lub Excel.

Po zatrzymaniu debugera, debugera nagle kończy proces aplikacji lub odłącza Jeśli debuger zestaw do odłączenia.Wszystkie dokumenty, które są otwierane w proces zostaje zakończony aplikacji pakietu Office są również zamknięty bez ostrzeżenia, a wszystkie niezapisane zmiany zostaną utracone.Może to obejmować wszystkie dokumenty lub skoroszytów, które są otwarte, gdy działa debuger.

Zazwyczaj lepiej jest odłączony od procesu przed zatrzymaniem debugera, tak, aby aplikacja pakietu Office można zamknąć w normalny sposób.Można również odłączyć od procesu po raz pierwszy, jeśli nadal chcesz pracować z otwartego dokumentu lub arkusza po zatrzymaniu debugera.Aby uzyskać więcej informacji na temat odłączania od procesu, zobacz Jak: Odłączanie wszystkich procesów.

Jeśli debugowania dostosowywania poziomie dokumentu dla programu Word, wielokrotnie zatrzymanie debugera i powodując nagle zamykanie programu Word może prowadzić do staje się uszkodzony szablon Normal.dot.Jeśli tak się stanie, można usunąć uszkodzony szablon Normal.dot i to zostanie utworzony automatycznie ponownie przy następnym otwarciu programu Word.Jednak nie zostaną odtworzone wszystkie makra, które były przechowywane w szablonie Normal.dot.

F10 i zachowanie F11

Podczas uruchamiania debugowania Office project F10 i F11 mają takie samo zachowanie jak podczas uruchamiania debugowania innych projektów Visual Basic lub C#.W projektach programu Visual Basic lub C# debuger zatrzyma się na główną funkcją; w projektach dla pakietu Office Visual Studio nie ma kontroli nad główną funkcją aplikacji pakietu Office.Jednak podczas debugowania, F10 i F11 mają tych samych funkcji, projekty języka Visual Basic i C#.

Wyświetlanie wyjątków

Ze względu na sposób, że kod zarządzany współdziała z niezarządzanego kodu Visual Studio nie zawiera błędów wygenerowanych przez aplikacje Microsoft Office.Na przykład jeśli dodatek utworzone za pomocą narzędzia programowania pakietu Office w programie Visual Studio, zgłasza wyjątek, aplikacja Microsoft Office nadal bez wyświetlania błąd.Aby zobaczyć te błędy, należy ustawić debuger do dzielenia na wyjątków CLR.Aby uzyskać więcej informacji, zobacz Jak: podział gdy wyjątek.

Jeśli debuger do dzielenia na wyjątków CLR, wszystkie wyjątki będą teraz włamać się do debugera, w tym te, które mają być obsługiwane i niektóre wyjątki pierwszej szansy od środowiska wykonawczego, który nie może być powiązane z projektem.Błędy odnoszące się do msosec, nie znaleziono pojawiają się w każdym projekcie, ale są bezpiecznie zignorować.Wyjątki te msosec nie ma wpływu na rozwiązanie.

Można również użyć Try...Catch instrukcji wokół swoje metody, aby przechwytywać wyjątków.

Domyślnie Visual Studio również nie wyświetlania Just In Time debugowania błędy dla Biura projektów; Jednakże można włączyć tę funkcję, dzięki czemu można zobaczyć błędy, które są wywoływane.Aby uzyskać więcej informacji, zobacz W czasie debugowania.

Argumenty wiersza polecenia

Jeśli Rozpocząć działania na Debug strona właściwość jest ustawiona na Rozpocząć projekt, Visual Studio nie używa argumentów wiersza polecenia podczas debugowania projektu, nawet jeśli określono argumenty wiersza polecenia jako opcji uruchamiania.Jeśli chcesz używać argumentów wiersza polecenia podczas uruchamiania debugowania, należy wybrać Rozpocząć działania inne niż Rozpocząć projekt.

Kontrola źródła

Program Debug: polecenie Właściwości nie są współużytkowane przez wielu użytkowników, pod kontrolą źródła.Projekty języka Visual Basic i C# przechowywane właściwości debugowania w pliku użytkownika (ProjectName. vbproj.user lub NazwaProjektu. csproj.user), i ten plik nie jest pod kontrolą źródła.Jeśli debugowanie jest więcej niż jedna osoba, każda osoba właściwości debug ręcznie wprowadzić.

Debugowania pamięci podręcznej zestawów danych w projekcie na poziomie dokumentu

Za każdym razem, gdy utworzenie projektu obiektu dataset opróżnić i ponownie utworzony.Jeśli chcesz debugować buforowanego zestawu danych, należy otworzyć dokument poza Visual Studio, a następnie dołączyć debugera.

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

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

Debugowanie wyłączone dodatki

Aplikacje Microsoft Office można wyłączyć dodatki, które zachowują się nieoczekiwanie.Aplikacji pakietu Microsoft Office wyłącza dodatki zapobiegające problematyczny kod ładowania co czas uruchamiania aplikacji.Jednak również jest łatwe spowodować nieoczekiwane zachowanie podczas debugowania typowe.Aby uzyskać informacje o tym, jak ponownie włączyć dodatki, zobacz Jak: ponownie włączyć dodatek został wyłączony.

Istnieją dwa rodzaje wyłączenie, że aplikacje Microsoft Office używają dla dodatków: wyłączanie twarde i miękkie wyłączenie.

Wyłączanie twardy

Ciężko wyłączenie może wystąpić, gdy dodatek powoduje nieoczekiwane zamykanie aplikacji.To może również wystąpić na komputerze dewelopera przerwanie debugera, podczas gdy Startup jest wykonywanie programu obsługi zdarzeń w dodatku.Gdy dodatek jest twardy osób niepełnosprawnych, pojawia się w Elementy wyłączone listy w aplikacji.

Jeśli w aplikacji pakietu Office trudne wyłącza dodatek utworzone za pomocą narzędzia programowania pakietu Office w programie Visual Studio, aplikacja wyłącza tylko dodatek, który spowodował błąd.Inne dodatki utworzone za pomocą narzędzia programowania pakietu Office w programie Visual Studio dla tej aplikacji pakietu Office będą ładowane.

Wyłączanie miękkie

Wyłączanie miękkie może wystąpić, gdy dodatek generuje błąd, który nie powoduje nieoczekiwane zamknięcie.Na przykład, aplikacja soft może wyłączyć dodatek, jeśli rzuca nieobsługiwany wyjątek podczas Startup jest wykonywanie programu obsługi zdarzeń.Gdy dodatek jest wyłączone miękkie, pojawia się w dodatki aplikacji nieaktywnych listy w aplikacji i aplikacji zmienia wartość LoadBehavior wpis rejestru dla dodatku do wskazania, że jest zwolniony.Aby uzyskać więcej informacji o LoadBehavior wpis rejestru, zobacz Wpisy rejestru na poziomie aplikacji dodatki.

Rozwiązywanie problemów z błędami instalacji za pomocą Podglądu zdarzeń

Visual Studio 2010 Tools for Office Runtime Zapisuje komunikaty w Podglądzie zdarzeń systemu Windows dla wszystkich wyjątków, które są generowane podczas instalowania lub odinstalowywania rozwiązania pakietu Office.Te wiadomości można użyć do rozwiązywania problemów wdrażania i instalacji.

Rozwiązywanie problemów z uruchamianiem za pomocą pliku dziennika i komunikaty o błędach

Visual Studio 2010 Tools for Office Runtime Można zapisywać wszystkie błędy, które występują podczas uruchamiania dziennika plik i wyświetlić każdy błąd w oknie komunikatu.Te opcje są domyślnie wyłączone.Opcje można włączyć, tworząc zmienne środowiskowe.

Aby wyświetlić każdy błąd w oknie komunikatu, należy utworzyć zmienną środowiskową o nazwie VSTO_SUPPRESSDISPLAYALERTS i ustawić ją na 0 (zero).Wiadomości można pominąć przez usunięcie zmiennej środowiskowej lub na 1 (jeden).

Aby zapisać w pliku dziennika błędów, utworzyć zmienną środowiskową o nazwie VSTO_LOGALERTS i ustawić ją na 1 (jeden).Visual Studio 2010 Tools for Office Runtime Tworzy plik dziennika w folderze, który zawiera manifest wdrażania dodatku lub w folderze, który zawiera dokument lub skoroszyt, który jest skojarzony z dostosowywania.Jeśli się nie powiedzie, Visual Studio 2010 Tools for Office Runtime tworzy plik dziennika w folderze % TEMP % lokalnych.Na poziomie aplikacji dodatków, domyślną nazwą jest Nazwa w. vsto.log.Dla projektów na poziomie dokumentu, nazwa pliku dziennika jest Nazwa dokumentu. rozszerzenie.log, takich jak ExcelWorkbook1.xlsx.log.Aby zatrzymać rejestrowanie błędów, należy usunąć zmiennej środowiskowej lub wynosi 0 (zero).

Zobacz też

Zadania

Jak: ponownie włączyć dodatek został wyłączony

Inne zasoby

Konstruowanie rozwiązań pakietu Office

Programowanie aplikacji poziom dodatki