ATLTraceTool-Beispiel: Zeigt die Ausgabe von ATLTRACE2
Aktualisiert: November 2007
Das ATLTraceTool-Beispiel erstellt eine Anwendung, mit der festgelegt wird, welche ATLTRACE2-Meldungen im Ausgabefenster angezeigt werden. Von dieser Anwendung, dem ATL Trace Tool, werden Debugablaufverfolgungsmeldungen in den ATL- und MFC-Quellen angezeigt. Sie können den Typ und die Anzahl der angezeigten Meldungen steuern.
AtlTraceTool.exe gehört zum Lieferumfang von Visual Studio und befindet sich im Verzeichnis \Programme\Microsoft Visual Studio 9.0\Common7\Tools. AtlTraceTool.exe steht auch in der Entwicklungsumgebung im Menü Tools zur Verfügung.
.gif "Sicherheitshinweis") Sicherheitshinweis: |
|---|
Dieser Beispielcode dient dazu, ein Konzept zu veranschaulichen. Er sollte nicht für Anwendungen oder Websites verwendet werden, da dieser Code unter Umständen nicht die sicherste Codierungstechnik darstellt. Microsoft übernimmt keine Haftung für beiläufig entstandene Schäden oder Folgeschäden, falls der Beispielcode nicht bestimmungsgemäß verwendet wird. |
So rufen Sie Beispiele und Anweisungen für ihre Installation ab
Klicken Sie in Visual Studio im Menü Hilfe auf Beispiele.
Weitere Informationen finden Sie unter Suchen von Beispieldateien.
Die neueste Version und vollständige Liste mit Beispielen ist online unter Visual Studio 2008 Samples verfügbar.
Sie können auch Beispiele auf der Festplatte des Computers suchen. Standardmäßig werden Beispiele und eine Infodatei in einen Ordner unter \Programme\Visual Studio 9.0\Samples\ kopiert. Für Express Editions von Visual Studio sind alle Beispiele online verfügbar.
Erstellen und Ausführen des Beispiels
So erstellen Sie dieses Beispiel und führen es aus
Öffnen Sie die Projektmappe tracetool.sln.
Klicken Sie im Menü Erstellen auf die Option Erstellen.
Klicken Sie im Menü Debuggen auf Starten ohne Debuggen.
.gif "Hinweis") Hinweis: |
|---|
Diese Prozedur ist optional. Sie können stattdessen auch die bereits erstellte AtlTraceTool.exe verwenden. |
So verwenden Sie ATLTraceTool.exe
Debuggen Sie ein MFC- oder ATL-Projekt, indem Sie im Menü Debuggen auf Starten klicken.
Klicken Sie im Menü Extras auf MFC/ATL-Ablaufverfolgungsprogramm, falls es nicht bereits ausgeführt wird.
Erweitern Sie im Fenster Ablaufverfolgungsliste die Strukturansichtsliste. Das Fenster zeigt die ausgeführte Anwendung, alle Module innerhalb dieser Anwendung und deren Ablaufverfolgungskategorien an.
Geben Sie für alle Prozesse, Module und Kategorien an, welche Informationen im Ausgabefenster angezeigt werden sollen. Das Steuerelement Ablaufverfolgungsebene in der Gruppe Prozess bezieht sich auf die ATLTRACE2-Ebene. Im Ausgabefenster werden nur solche ATLTRACE2-Meldungen angezeigt, deren Ebene gleich oder höher als die im Steuerelement Ablaufverfolgungsebene eingestellte Ebene ist.
Klicken Sie auf Übernehmen, um die Einstellungen zu bestätigen.
Sie können die Einstellungen speichern und beim nächsten Debuggen der Anwendung wieder laden. Verwenden Sie dazu die Schaltflächen Speichern und Laden.
Benutzeroberfläche des ATL Trace-Tools
Ablaufverfolgungsliste
Eine Strukturansicht mit einer Liste der Prozesse, die ATL-/MFC-Debugquellen verwenden. Unter jedem Prozess werden Module und unter jedem Modul werden Ablaufverfolgungskategorien aufgelistet.Aktualisieren
Aktualisiert die Liste der unter Ablaufverfolgungsliste aufgeführten Prozesse und Module.Prozessgruppe
Prozessweite Einstelllungen:Ablaufverfolgungsebene – Entspricht dem Ablaufverfolgungsebenen-Parameter in Aufrufen von ATLTRACE2. Derzeit verwenden die ATL-/MFC-Quellen eine Ablaufverfolgungsebene von 0–4, wobei die Ebene 0 die kritischste Ebene ist.
Aktivieren – Aktiviert die Ablaufverfolgung für den Prozess.
Kategorie & Funktionsnamen – Enthält die Ablaufverfolgungskategorie und den Funktionsnamen in Ablaufverfolgungsmeldungen.
Dateiname und Zeilennummer – Schließt den Dateinamen und die Zeilennummer in Ablaufverfolgungsmeldungen ein.
Modulgruppe
Zunächst müssen Sie ein Modul in der Strukturansicht Ablaufverfolgungsliste auswählen, bevor diese Gruppe aktiviert wird. Diese Einstellungen wirken sich auf das Modul aus.Ablaufverfolgungsebene – Entspricht dem Ablaufverfolgungsebenen-Parameter in Aufrufen von ATLTRACE2. Derzeit verwenden die ATL-/MFC-Quellen eine Ablaufverfolgungsebene von 0–4, wobei die Ebene 0 die kritischste Ebene ist.
Vom Prozess erben – Ablaufverfolgungseinstellungen in der Gruppe Prozess dürfen auch für dieses Modul verwendet werden.
Aktivieren – Aktiviert die Ablaufverfolgung für dieses Modul.
Deaktivieren – Deaktiviert die Ablaufverfolgung für dieses Modul.
Kategoriegruppe
Zunächst müssen Sie eine Kategorie in der Strukturansicht Ablaufverfolgungsliste auswählen, bevor diese Gruppe aktiviert wird. Diese Einstellungen wirken sich auf die Kategorie innerhalb des Moduls aus.Ablaufverfolgungsebene – Entspricht dem Ablaufverfolgungsebenen-Parameter in Aufrufen von ATLTRACE2. Derzeit verwenden die ATL-/MFC-Quellen eine Ablaufverfolgungsebene von 0–4, wobei die Ebene 0 die kritischste Ebene ist.
Vom Modul erben – Ablaufverfolgungseinstellungen in der Gruppe Modul dürfen auch für diese Kategorie verwendet werden.
Aktivieren – Aktiviert die Ablaufverfolgung für diese Kategorie.
Deaktivieren – Deaktiviert die Ablaufverfolgung für diese Kategorie.
Speichern
Speichert die Einstellungen für den aktuellen Prozess sowie untergeordnete Module in einer TRC-Datei. Sie können die TRC- Datei laden, indem Sie auf die Schaltfläche Laden klicken oder AtlTraceLoadSettings aus dem Projekt aufrufen. Wenn die TRC-Datei sich im selben Verzeichnis wie die EXE/DLL befindet, können Sie AtlTraceLoadSettings aufrufen und für den Dateinamen NULL übergeben.Laden
Lädt eine TRC-Datei.Übernehmen
Wendet die aktuellen Einstellungen auf den geladenen Prozess an.Schließen
Schließt das Dialogfeld ATL/MFC-Ablaufverfolgungsprogramm. Die Änderungen werden erst übernommen, nachdem Sie Übernehmen ausgewählt haben.Hilfe
Zeigt die Hilfe an.