Debuggen in Projekten auf Dokumentebene
Aktualisiert: November 2007
Betrifft |
|---|
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp
Microsoft Office-Version
Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp. |
Sie können Projekte auf Dokumentebene für Microsoft Office Word und Microsoft Office Excel mit denselben Visual Studio-Tools debuggen, die Sie auch in anderen Projekten verwenden. Beim Ausführen eines Projekts im Debugmodus startet Visual Studio entweder Word oder Excel, und der Debugger überwacht die Ausführung Ihres Codes, der im Prozess von Word oder Excel ausgeführt wird. Weitere Informationen zu den Debugtools von Visual Studio finden Sie unter Debuggen in Visual Studio.
.gif "Tipp") Tipp: |
|---|
Schließen Sie vor dem Erstellen und Debuggen alle geöffneten Instanzen von Word oder Excel, um Konflikte zu vermeiden. |
Verhalten von F10 und F11
Beim Starten des Debuggens eines Office-Projekts haben F10 und F11 eine andere Funktion als beim Starten des Debuggens anderer Visual Basic- oder C#-Projekte. In Visual Basic- oder C#-Projekten wird der Debugger bei der main-Funktion angehalten. In Office-Projekten besitzt Visual Studio dagegen keine Kontrolle über die main-Funktion der Office-Anwendung. Während des Debuggens hingegen haben F10 und F11 dieselben Funktionen wie in Visual Basic- und C#-Projekten. Weitere Informationen finden Sie unter Tastenkombinationen für das Debuggen, Brief-Schema.
Beenden des Debuggers
Wenn Sie mit dem Debuggen eines Dokuments oder einer Arbeitsmappe beginnen, wird das Dokument oder die Arbeitsmappe in einem neuen Word- oder Excel-Prozess geöffnet. Wenn Sie den Debugger beenden, beendet dieser abrupt den Word- oder Excel-Prozess oder trennt sich vom Prozess, sofern Sie ihn entsprechend eingerichtet haben. Alle anderen Dokumente oder Arbeitsmappen, die in einem Word- oder Excel-Prozess geöffnet sind, der jetzt beendet wird, werden ohne Warnung ebenfalls geschlossen, wobei alle nicht gespeicherten Änderungen verloren gehen. Dazu können alle Dokumente oder Arbeitsmappen gehören, die geöffnet werden, während der Debugger ausgeführt wird. Es ist besser, den Debugger vom Prozess zu trennen, bevor Sie ihn beenden. So können Sie Word und Excel normal beenden.
Das wiederholte Beenden des Debuggers und das damit einhergehende plötzliche Beenden von Word während umfangreicher Debugsitzungen kann zur Beschädigung von Normal.dot führen. Wenn das geschieht, können Sie die Vorlage Normal.dot löschen. Sie wird beim nächsten Öffnen von Word automatisch neu erstellt. In der Vorlage gespeicherte Makros werden allerdings nicht neu erstellt.
Wenn Sie den Debugger beenden, aber an einem Dokument oder Arbeitsblatt weiterarbeiten möchten, müssen Sie zunächst den Debugger vom Prozess trennen und ihn dann beenden. Weitere Informationen hierzu finden Sie unter Gewusst wie: Trennen aller Prozesse.
Word sperrt Normal.dot, während es in Visual Studio geöffnet ist
Wenn Word in Visual Studio geöffnet ist, ist die Standardvorlage Normal.dot gesperrt. Wenn Sie die Projektmappe zum Debuggen ausführen, wird eine Kopie von Word in einem anderen Prozess geöffnet. Wenn Sie darin Anpassungen auf Anwendungsebene vornehmen, zum Beispiel Symbolleisten oder Menüs ändern, können Sie diese Änderungen nicht speichern, da Normal.dot durch den in Visual Studio geöffneten Prozess gesperrt ist.
Zur Laufzeit öffnet Word separate Instanzen von Dokumenten in einem einzigen Prozess. Daher ist es unwahrscheinlich, dass ein geöffnetes Dokument Normal.dot sperrt und Änderungen auf Anwendungsebene verhindert.
Weitere Informationen finden Sie im Knowledge Base-Artikel "PRB: Prompt to Save Normal.dot When Using Word as an Automation Server" (https://support.microsoft.com/default.aspx?scid=kb;de-de;285885).
Debuggen zwischengespeicherter Datasets
Bei jeder Erstellung eines Projekts wird das Dataset geleert und neu erstellt. Wenn Sie ein zwischengespeichertes Dataset debuggen möchten, müssen Sie das Dokument außerhalb von Visual Studio öffnen und dann den Debugger anfügen.
Debuggen von Word 2007-Projekten auf Grundlage des Dokumentformats für Word 97-2003 (*.doc).
Um ein Word 2007-Dokumentprojekt zu debuggen, das auf dem Dokumentformat für Word 97-2003 (*.doc) basiert, müssen Sie den Projektordner zur Liste vertrauenswürdiger Ordner hinzufügen. Weitere Informationen hierzu finden Sie unter Gewähren von Vertrauenswürdigkeit für Dokumente (2007 System).
Quellcodeverwaltung
In der Quellcodeverwaltung werden Debugeigenschaften nicht für mehrere Benutzer gemeinsam verwendet. In Visual Basic-Projekten und C#-Projekten werden die Debugeigenschaften in einer benutzerspezifischen Datei (<ProjectName>.vbproj.user oder <ProjectName>.csproj.user) gespeichert, und diese Datei wird nicht in die Quellcodeverwaltung einbezogen. Wenn mehrere Personen debuggen, muss jede Person die Debugeigenschaften manuell eingeben.
Befehlszeilenargumente
Wenn auf der Debugeigenschaftenseite die Startaktion auf Projekt starten festgelegt wird, werden beim Debuggen des Projekts von Visual Studio keine Befehlszeilenargumente verwendet. Dies ist auch dann der Fall, wenn Befehlszeilenargumente als Startoptionen angegeben wurden. Wenn Sie beim Debuggen Befehlszeilenargumente verwenden möchten, müssen Sie eine andere Startaktion als Projekt starten auswählen.
Problembehandlung mithilfe einer Protokolldatei und Fehlermeldungen
Alle Fehler können von Visual Studio Tools for Office in eine Protokolldatei geschrieben werden. In der Standardeinstellung ist diese Option für Word- und Excel-Projekte deaktiviert. Sie können diese Option aktivieren, indem Sie die VSTO_LOGALERTS-Umgebungsvariable hinzufügen und deren Wert auf 1 (eins) festlegen. Visual Studio Tools for Office erstellt die Protokolldatei im Ausgabeordner, in dem das Projektmappendokument erstellt wird. Wenn dies nicht möglich ist, wird die Datei im Ordner %TEMP% erstellt. Der Standardname der Protokolldatei ist <Documentname>.doc.log für Word und <Documentname>.xls.log für Excel. Sie können das Protokollieren von Fehlern beenden, indem Sie den Wert der Variablen auf 0 (null) festlegen.
In der Standardeinstellung für Word- und Excel-Projekte wird jeder Fehler von Visual Studio Tools for Office in einem Meldungsfeld angezeigt. Sie können das Anzeigen von Fehlermeldungen durch Visual Studio Tools for Office beenden, indem Sie die VSTO_SUPPRESSDISPLAYALERTS-Umgebungsvariable hinzufügen und deren Wert auf 1 (eins) festlegen. Legen Sie den Wert der Variablen auf 0 (null) fest, um die Fehlermeldungen anzuzeigen.
Informationen zum Festlegen von Umgebungsvariablen in Microsoft Windows XP finden Sie unter "SO WIRD'S GEMACHT: Verwalten von Umgebungsvariablen in Windows XP" (https://support.microsoft.com/default.aspx?scid=kb;de-de;310519).
Siehe auch
Aufgaben
Gewusst wie: Behandeln von Fehlern in Office-Projekten
Konzepte
Bereitstellen von Office-Projektmappen (2003 System)
Bereitstellen von Office-Projektmappen (2007 System)
Erstellen von Office-Projektmappen in Visual Studio
Übersicht über das Erstellen von Office-Projektmappen