在 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 消息文本框。

“ 更改时 ”选项的行为对于不同的编程语言不同。

• 对于本机代码，调试器不会将条件的第一个评估视为更改，因此不会在第一次评估中命中跟踪点。
• 对于托管代码，调试器会在选择 “更改后 ”在第一次评估中命中跟踪点。

还可以通过将断点插入到代码的任何特定部分并选择复选框来设置跟踪点启用的条件：在“断点设置”菜单中的“断点设置”菜单中选择“仅启用”复选框。 可以从选项列表中选择任何断点。

若要更全面地了解设置条件时可以使用的有效表达式，请参阅 调试器中的表达式。

获取 AI 帮助

如果你有 Copilot，则可以在创建跟踪点时获得 AI 帮助。 Copilot 提供有关特定于代码 的条件断点 和 跟踪点 的建议。

有关详细信息，请参阅 使用 Copilot 进行调试。

对于条件表达式，仅当满足某些条件时，输出消息才会显示。

对于条件表达式，可以将跟踪点设置为在某个条件为 true 或更改消息时输出消息。 例如，如果只想在循环迭代 for 期间显示计数器的值，则可以选择 “为 true ”选项，然后键入 i%2 == 0 消息文本框。

如果要在循环迭代 for 发生更改时打印计数器的值，请选择 “更改时间 ”选项并键入 i 消息文本框。

“ 更改时 ”选项的行为对于不同的编程语言不同。

• 对于本机代码，调试器不会将条件的第一个评估视为更改，因此不会在第一次评估中命中跟踪点。
• 对于托管代码，调试器会在选择 “更改后 ”在第一次评估中命中跟踪点。

若要更全面地了解设置条件时可以使用的有效表达式，请参阅 调试器中的表达式。

命中计数条件仅允许在设置跟踪点的代码行执行指定次数后发送输出。

对于命中计数，可以选择在设置跟踪点的代码行执行特定次数时输出消息。 根据要求，它可以等于或为倍数，或大于或等于指定的命中计数值。 选择最适合你的需求的选项，并在字段中键入一个整数值（例如，5），表示感兴趣的迭代。

命中计数条件仅允许在设置跟踪点的代码行执行指定次数后发送输出。

对于命中计数，可以选择在设置跟踪点的代码行执行特定次数时输出消息。 根据要求，它可以等于或为倍数，或大于或等于指定的命中计数值。 选择最适合你的需求的选项，并在字段中键入一个整数值（例如，5），表示感兴趣的迭代。

还可以通过启用复选框“ 删除断点”来删除第一次命中的断点。

对于筛选器条件，请指定显示哪些设备、进程或线程输出。

筛选器表达式列表：

• MachineName = “name”
• ProcessId = 值
• ProcessName = “name”
• ThreadId = 值
• ThreadName = “name”

用双引号将字符串（如名称）括起来。 可以输入值而不带引号。 可以使用 （）、（AND）、 ||! （ORNOT） 和括号合并子句&。

对于筛选器条件，请指定显示哪些设备、进程或线程输出。

筛选器表达式列表：

• MachineName = “name”
• ProcessId = value
• ProcessName = “name”
• ThreadId = value
• ThreadName = “name”

用双引号将字符串（如名称）括起来。 可以输入值而不带引号。 可以使用 （）、（AND）、 ||! （ORNOT） 和括号合并子句&。