共用方式為

ATLTraceTool 範例：顯示 ATLTRACE2 的輸出

  • 發行項

更新：2007 年 11 月

ATLTraceTool 範例會建置一個應用程式，這個應用程式會指定輸出視窗中要顯示哪一個 ATLTRACE2 訊息。這個 ATL 追蹤工具應用程式會顯示 ATL 和 MFC 來源中的偵錯追蹤訊息。您可以控制顯示的訊息的類型和數量。

AtlTraceTool.exe 會隨 Visual Studio 提供，您可以在 \Program Files\Microsoft Visual Studio 9.0\Common7\Tools 目錄中找到，也可以從程式開發環境中的 [工具] 功能表存取 AtlTraceTool.exe。

安全性注意事項：

這個程式碼範例僅供概念說明之用，同時因為範例中的程式碼撰寫並沒有周全的顧及所有安全性問題，所以本範例不適用於實際執行的應用程式或網站中。如果使用者擅自將範例程式碼用於其他意圖而導致連帶事件或重大損害時，Microsoft 將不承擔任何責任。

若要取得範例和指示以便進行安裝：

  • 按一下 Visual Studio [說明] 功能表上的 [範例]。

    如需詳細資訊，請參閱尋找範例檔案。

  • 最新版的完整範例清單可從 Visual Studio 2008 範例網頁 (英文) 取得。

  • 您也可以將範例置於電腦硬碟中。根據預設，範例和讀我檔案都會複製到 \Program Files\Visual Studio 9.0\Samples\ 下的資料夾中。對於所有的 Visual Studio Express 版，所有範例都可在線上找到。

建置和執行範例

若要建置和執行這個範例

  1. 開啟 tracetool.sln 方案檔。

  2. 從 [建置] 功能表中，按一下 [建置]。

  3. 從 [偵錯] 功能表中，按一下 [啟動但不偵錯]。

注意事項：

這是一個選擇性的程序。您也可以改用預先建置的 AtlTraceTool.exe。

若要使用 ATLTraceTool.exe

  1. 從 [偵錯] 功能表中，按一下 [啟動]，偵錯 MFC 或 ATL 專案。

  2. 從 [工具] 功能表中，按一下 [MFC/ATL 追蹤工具] (如果它尚未執行)。

  3. 在 [追蹤清單] 視窗中，展開樹狀控制清單。這個視窗會顯示執行中的應用程式、在該應用程式中的任何模組，以及每一個模組的追蹤分類。

  4. 針對每一個處理序，自訂模組和分類 (這些項目的資訊會顯示在輸出視窗中)。處理序群組中的 [追蹤層級] 控制項與 ATLTRACE2 層級有關；輸出視窗中將只會顯示其層級等於或高於 [追蹤層級] 控制項中設定的 ATLTRACE2 訊息。

  5. 按一下 [套用]，讓設定生效。

您可以儲存您的設定，並在下次偵錯應用程式時加以載入 (使用 [儲存] 和 [載入] 按鈕)。

ATL 追蹤工具使用者介面

  • 追蹤清單
    樹狀控制項，具有使用偵錯 ATL/MFC 來源的處理序清單。每個處理序之下都會列出模組，而每個模組之下則會列出追蹤分類。

  • 重新整理
    更新處理序清單和 [追蹤清單] 之下的模組。

  • 處理序群組
    處理序範圍的設定：

    追蹤層級 -- 等於呼叫 ATLTRACE2 中的追蹤層級參數。目前 ATL/MFC 來源是使用 0–4 的追蹤層級，其中 0 為最重要的層級。

    啟用 -- 啟用處理序的追蹤。

    分類和函式名稱 -- 包含追蹤訊息中的追蹤分類和函式名稱。

    檔名和行號 -- 在追蹤訊息中包含檔名和行號。

  • 模組群組
    在啟用這個群組之前，您必須從 [追蹤清單] 樹狀控制項中選取一個模組。這些設定會影響該模組。

    追蹤層級 -- 等於呼叫 ATLTRACE2 中的追蹤層級參數。目前 ATL/MFC 來源是使用 0–4 的追蹤層級，其中 0 為最重要的層級。

    繼承自處理序 -- 允許 [處理序] 群組中的追蹤設定也能用在這個模組中。

    啟用 -- 啟用這個模組的追蹤。

    停用 -- 停用這個模組的追蹤。

  • 分類群組
    在啟用這個群組之前，您必須先從 [追蹤清單] 樹狀控制項中選取一個分類。這些設定會影響該模組內的分類。

    追蹤層級 -- 等於呼叫 ATLTRACE2 中的追蹤層級參數。目前 ATL/MFC 來源是使用 0–4 的追蹤層級，其中 0 為最重要的層級。

    繼承自模組 -- 允許 Module 群組中的追蹤設定也能用在這個分類中。

    啟用 -- 啟用這個分類的追蹤。

    停用 -- 停用這個分類的追蹤。

  • 儲存
    將目前處理序的設定和所有在它之下的模組儲存為 .trc 檔。.trc 檔可以透過使用 [載入] 按鈕或藉由從專案中呼叫 AtlTraceLoadSettings 來載入。如果 .trc 檔位於和 EXE/DLL 相同的目錄中，則您可以呼叫 AtlTraceLoadSettings 並傳送 NULL 做為檔名。

  • 載入
    載入 .trc 檔。

  • 套用
    將目前的設定套用至載入的處理序。

  • 關閉
    關閉 [ATL/MFC 追蹤工具] 對話方塊。除非選取 [套用]，否則變更將不會生效。

  • 說明
    顯示說明。

請參閱

其他資源

ATL 範例