Debugowanie projektów pakietu Office
Biuro projektów można debugować za pomocą samego programu Microsoft Visual Studio narzędzia użyć dla innych Visual Studio projektów.Visual StudioDebuger funkcje, takie jak możliwość wstawiania punkty przerwania i wyświetlanie zmiennych w mieszkańców okna, są również dostępne podczas debugowania projektach dla pakietu Office.Aby uzyskać więcej informacji o Visual Studio narzędzi do debugowania, zobacz Debugowanie w Visual Studio.
.gif "Porada") Porada |
|---|
W celu uproszczenia, debugowanie, zamknij wszystkie wystąpienia aplikacji pakietu Office, zanim budować i Debuguj je. |
Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu i aplikacji obsługiwanych w pakietach Office 2013 i Office 2010. Zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.
.gif "łącze do wideo")
Aby wyświetlić pokrewne wideo demonstracyjne, zobacz jak I: debugowania aplikacji VSTO?.
Uruchamianie i zatrzymywanie debugera
Można rozpocząć debugowanie projekcie programu Office tak samo, jak rozpocząć debugowanie inne Visual Studio projektów; na przykład można nacisnąć klawisz F5.Podczas uruchamiania debugowania na poziomie aplikacji dodatek programu project, uruchomiony nowy proces dla docelowej aplikacji pakietu Office i dodatek jest załadowany.Podczas uruchamiania debugowania projektu poziomie dokumentu, dokument lub skoroszyt zostanie otwarty w nowy proces programu Word lub Excel.
Po zatrzymaniu debugera, debugera kończy proces stosowania gwałtownie lub odłączenie Jeśli masz debugera zestaw do odłączenia.Wszystkie dokumenty, które są otwarte 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ą otwierane po uruchomieniu debugera.
Zazwyczaj lepiej jest odłączyć komputer 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 najpierw Jeśli nadal chcesz pracować z otwartego dokumentu lub arkusza po zatrzymaniu debugera.
Jeśli debugowania dostosowywania poziomie dokumentu dla programu Word, wielokrotnie zatrzymywanie 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 będzie można automatycznie ponownie przy następnym otwarciu programu Word.Jednakże żadne makra, które były przechowywane w szablonie Normal.dot nie zostaną odtworzone.
F10 i zachowanie F11
Podczas uruchamiania debugowania projekcie programu pakietu Office, F10 i F11 nie takie samo zachowanie jak podczas uruchamiania debugowania inne projekty języka Visual Basic lub C#.W projekty języka Visual Basic lub C# debuger zatrzyma się na główną funkcją; w projektach dla pakietu Office programu 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, w jaki kod zarządzany współdziała z niezarządzanego kodu Visual Studio nie wyświetla 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, aplikacji pakietu Microsoft Office nadal bez wyświetlania błąd.Aby wyświetlić te błędy, należy ustawić debugera do wspólnej language runtime wyjątków.Aby uzyskać więcej informacji, zobacz Porady: przerwanie przy wystąpieniu wyjątku.
Jeśli ustawisz debugera do wspólnej language runtime wyjątków, wszystkie wyjątki teraz podzielić debugera, w tym te, które zostały obsłużone i niektóre wyjątki szansy pierwszy od czasu wykonywania, który nie może być powiązane z projektem.Błędy odnoszące się do msosec nie znaleziono pojawiają się w każdym projektem, ale są bezpiecznie zignorować.Wyjątki te msosec nie wpłynie na rozwiązania.
Można również użyć Try...Catch instrukcji wokół Twoje metody, aby przechwytywać wyjątków.
Domyślnie Visual Studio również nie wyświetlania Just-In-Time debugowania błędy Biura projektów; można jednak włączyć tę funkcję, aby mogli przeglądać błędy, które są wywoływane.Aby uzyskać więcej informacji, zobacz Debugowanie just in time w programie Visual Studio.
Argumenty wiersza polecenia
Jeśli Rozpoczęcie akcji na Debug strona właściwość jest ustawiona na Start projektu, Visual Studio nie używa argumenty wiersza polecenia podczas debugowania projektu, nawet jeśli zostały podane argumenty wiersza polecenia jako opcji uruchamiania.Jeśli chcesz użyć argumenty wiersza polecenia podczas uruchamiania debugowania, należy wybrać Rozpoczęcie akcji innych niż Start projektu.
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 specyficzne dla użytkownika (ProjectName. vbproj.user lub ProjectName. csproj.user), i ten plik nie jest pod kontrolą źródła.Jeśli debugowanie jest więcej niż jedna osoba, każda osoba musi ręcznie wprowadź właściwości debugowania.
Debugowania pamięci podręcznej zestawów danych w projekcie poziomie dokumentu
Za każdym razem, aby zbudować projekt, zestaw danych opróżnić i ponownie utworzony.Jeśli chcesz debugować buforowanego zestawu danych, należy otworzyć dokument poza programem Visual Studio i następnie uruchomić debugera.
Debugowanie projektów dokumentu Word oparte na dokument programu Word 97–2003 (* .doc) Format
Aby debugować 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 dotyczących sposobu wykonania tego zadania, zobacz Udzielanie zaufania do dokumentów...
Debugowanie wyłączonych dodatków
Aplikacje Microsoft Office można wyłączyć dodatki, które nieoczekiwane zachowanie.Aplikacji pakietu Microsoft Office powoduje wyłączenie dodatków aby zapobiec problematyczny kod ładowania co czas uruchamiania aplikacji.Jednak również jest łatwy do spowodować nieoczekiwane zachowanie podczas debugowania typowe.Aby dowiedzieć się, jak ponownie włączyć dodatki, zobacz Porady: ponowne włączanie dodatku, który został wyłączony.
Istnieją dwa typy wyłączenia, że aplikacje Microsoft Office korzystają 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, że aplikacja jest nieoczekiwanie zamykany.To może wystąpić na komputerze dewelopera, jeśli zatrzymania debugera podczas Startup wykonywanie programu obsługi zdarzeń w dodatku.Gdy dodatek jest wyłączone twarde, 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 program obsługi zdarzeń jest wykonywany.Gdy dodatek jest wyłączone miękkie, pojawia się w dodatki aplikacji nieaktywnych listy w aplikacji, a aplikacja zmienia wartość LoadBehavior wpis rejestru dla dodatek do wskazania, że jest zwolniony.Aby uzyskać więcej informacji o LoadBehavior wpis rejestru, zobacz Wpisy rejestrów dla dodatków na poziomie aplikacji.
Rozwiązywanie problemów z błędami instalacji za pomocą Podglądu zdarzeń
Visual Studio 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 biurowe.Te wiadomości służy do rozwiązywania problemów wdrażania i instalacji.
Rozwiązywanie problemów z błędami uruchamiania za pomocą pliku dziennika i komunikaty o błędach
Visual Studio Tools for Office Runtime Można zapisywać wszystkie błędy, które występują podczas uruchamiania w dzienniku pliku i wyświetlić każdy błąd w oknie komunikatu.Opcje te są domyślnie wyłączone.Opcje można włączyć, tworząc zmiennych środowiskowych.
Aby wyświetlić każdy błąd w oknie komunikatu, należy utworzyć zmienną środowiskową o nazwie VSTO_SUPPRESSDISPLAYALERTS i ustawić ją na wartość 0 (zero).Wiadomości można pominąć przez usunięcie zmiennej środowiskowej lub ustawienie jej na 1 (jeden).
Aby błędów zapisu w pliku dziennika, należy utworzyć zmienną środowiskową o nazwie VSTO_LOGALERTS i ustawić ją na 1 (jeden).Visual Studio Tools for Office Runtime Plik dziennika jest tworzony w folderze, który zawiera manifest wdrażania dodatku lub w folderze, który zawiera dokument lub skoroszyt, który jest skojarzony z dostosowania.Jeśli to się nie powiedzie, Visual Studio Tools for Office Runtime tworzy plik dziennika w folderze lokalnym % TEMP %.Na poziomie aplikacji dodatki, domyślną nazwą jest add-in name. vsto.log.Dla projektów na poziomie dokumentu, nazwa pliku dziennika jest document name.extension.log, takich jak ExcelWorkbook1.xlsx.log.Aby zatrzymać rejestrowanie błędów, Usuń zmienną środowiskową lub wynosi 0 (zero).
Zobacz też
Zadania
Porady: ponowne włączanie dodatku, który został wyłączony