使用 Visual Studio 中的追蹤點將資訊記錄至 [輸出] 視窗

下列範例程式是一個簡單的 for 迴圈，其計數器變數會在每次迴圈執行另一個反覆項目時增加一。

下列範例程式是一個簡單的 for 迴圈，其計數器變數會在每次迴圈執行另一個反覆項目時增加一。

using System.Diagnostics;

namespace Tracepoints
{
    public class Program
    {
        public static void Main(string[] args)
        {
            int counter = 0;
            for (int i=0; i<=10; i++)
            {
                counter +=1;
            }
        }
    }
}

您可以在 [中斷點設定] 視窗中，指定 [動作] 核取方塊下的輸出字串來設定追蹤點。

1. 若要初始化追蹤點，請先按一下要設定追蹤點之行號左邊的裝訂邊。

   

2. 將滑鼠停留在紅色圓圈上，然後按一下齒輪圖示。

3. 此動作會開啟 [中斷點設定] 視窗。

   

4. 選取 [動作] 核取方塊。

   

   請注意紅色圓圈如何變更為菱形，指出您已從中斷點切換到追蹤點。

5. 將您要記錄的訊息輸入到 [在輸出視窗中顯示訊息] 文字輸入框 (如需詳細資訊，請參閱本文稍後的章節)。

   您的追蹤點現在已設定。 如果您只想將一些資訊記錄到輸出視窗，請點選 [關閉] 按鈕。

6. 如果您想要新增條件來決定是否顯示訊息，請選取 [條件] 核取方塊。

   

   您有三種條件選擇：條件運算式、篩選以及叫用次數。

您可以在 [中斷點設定] 視窗中，指定 [動作] 核取方塊下的輸出字串來設定追蹤點。

1. 若要初始化追蹤點，請先按一下要設定追蹤點之行號左邊的裝訂邊。

   

2. 將滑鼠停留在紅色圓圈上，然後按一下齒輪圖示，以開啟 [中斷點設定] 視窗。

   

3. 選取 [動作] 核取方塊。

   

   請注意紅色圓圈如何變更為菱形，指出您已從中斷點切換到追蹤點。

4. 將您要記錄的訊息輸入到 [在輸出視窗中顯示訊息] 文字輸入框 (如需詳細資訊，請參閱本文稍後的章節)。

   您的追蹤點現在已設定。 如果您只想將一些資訊記錄到輸出視窗，請點選 [關閉] 按鈕。

5. 如果您想要新增條件來決定是否顯示訊息，請選取 [條件] 核取方塊。

   

   您有三種條件選擇：條件運算式、篩選以及叫用次數。

此功能表可讓您將訊息記錄至 [輸出] 視窗。 將您想要輸出的字串輸入到訊息方塊中 (不需要引號)。 如果您想要顯示變數的值，請務必以大括弧將其括住。

例如，如果您想要在輸出主控台中顯示 counter 變數的值，請在訊息文字輸入框中輸入 {counter}。

如果您按一下 [關閉] 然後偵錯程式 (F5)，您會在 [輸出] 視窗中看到下列輸出。

您也可以使用特殊關鍵字來顯示更具體的資訊。 確實如下所示輸入關鍵字 (在每個關鍵字和關鍵字本身的大寫字前面使用 "$")。

此功能表可讓您將訊息記錄至 [輸出] 視窗。 將您想要輸出的字串輸入到訊息方塊中 (不需要引號)。 如果您想要顯示變數的值，請務必以大括弧將其括住。

例如，如果您想要在輸出主控台中顯示 counter 變數的值，請在訊息文字輸入框中輸入 {counter}。

如果您按一下 [關閉] 然後偵錯程式 (F5)，您會在 [輸出] 視窗中看到下列輸出。

您也可以使用特殊關鍵字來顯示更具體的資訊。 確實如下所示輸入關鍵字 (在每個關鍵字和關鍵字本身的大寫字前面使用 "$")。

針對條件運算式，只有在符合特定條件時，才會顯示輸出訊息。

針對條件運算式，您可以在特定條件為 true 或變更時，將追蹤點設定為輸出訊息。 例如，如果您只想在 for 迴圈的反覆項目期間顯示計數器的值，則可以選取 [為 true] 選項，然後在訊息文字輸入框中輸入 i%2 == 0。

如果您想要在 for 迴圈反覆項目變更時列印計數器的值，請選取 [變更時] 選項，然後在訊息文字輸入框中輸入 i。

[變更時] 選項的行為，會隨不同的程式設計語言而異。

• 針對原生程式碼，偵錯工具不會將第一次條件評估視為變更，因此不會在第一次評估時叫用追蹤點。
• 針對受控程式碼，偵錯工具會在選取 [變更時] 之後，於第一個評估中叫用追蹤點。

如需在設定條件時可以使用的有效運算式，請參閱偵錯工具中的運算式。

針對條件運算式，只有在符合特定條件時，才會顯示輸出訊息。

針對條件運算式，您可以在特定條件為 true 或變更時，將追蹤點設定為輸出訊息。 例如，如果您只想在 for 迴圈的反覆項目期間顯示計數器的值，則可以選取 [為 true] 選項，然後在訊息文字輸入框中輸入 i%2 == 0。

如果您想要在 for 迴圈反覆項目變更時列印計數器的值，請選取 [變更時] 選項，然後在訊息文字輸入框中輸入 i。

[變更時] 選項的行為，會隨不同的程式設計語言而異。

• 針對原生程式碼，偵錯工具不會將第一次條件評估視為變更，因此不會在第一次評估時叫用追蹤點。
• 針對受控程式碼，偵錯工具會在選取 [變更時] 之後，於第一個評估中叫用追蹤點。

您也可以將中斷點插入程式碼的任何特定區段，然後選取 [中斷點設定] 功能表中的 [只有在叫用下列中斷點時啟用：] 核取方塊，來設定啟用追蹤點的條件。 您可以從選項清單中選擇任何中斷點。

如需在設定條件時可以使用的有效運算式，請參閱偵錯工具中的運算式。

叫用次數條件可讓您只在設定追蹤點的程式碼執行指定的次數之後，才會傳送輸出。

針對叫用次數，您可以選擇在設定追蹤點的程式碼已執行特定次數時輸出訊息。 根據需求，可以等於或為倍數，或者大於或等於指定的叫用次數值。 選擇最符合您需求的選項，並在欄位中輸入整數值 (例如 5)，代表感興趣的反覆項目。

叫用次數條件可讓您只在設定追蹤點的程式碼執行指定的次數之後，才會傳送輸出。

針對叫用次數，您可以選擇在設定追蹤點的程式碼已執行特定次數時輸出訊息。 根據需求，可以等於或為倍數，或者大於或等於指定的叫用次數值。 選擇最符合您需求的選項，並在欄位中輸入整數值 (例如 5)，代表感興趣的反覆項目。

您也可以藉由啟用 [叫用之後移除中斷點] 核取方塊，來移除第一次叫用的中斷點。

針對篩選條件，指定針對哪些裝置、程序或執行緒輸出顯示。

篩選條件運算式的清單：

• MachineName = "名稱"
• ProcessId = 值
• ProcessName ="名稱"
• ThreadId = 值
• ThreadName = "名稱"

以雙引號括住字串 (例如名稱)。 可以不加上引號來輸入值。 您可以使用以下項目來結合子句：& (AND)、|| (OR)、! (NOT) 和括號。

針對篩選條件，指定針對哪些裝置、程序或執行緒輸出顯示。

篩選條件運算式的清單：

• MachineName = "name"
• ProcessId = value
• ProcessName = "name"
• ThreadId = value
• ThreadName = "name"

以雙引號括住字串 (例如名稱)。 可以不加上引號來輸入值。 您可以使用以下項目來結合子句：& (AND)、|| (OR)、! (NOT) 和括號。