Visual Studio のトレースポイントを使用して出力ウィンドウに情報をログに記録する

次のプログラム例は、ループが別のイテレーションを実行するたびに 1 つずつ増加するカウンター変数を持つ単純な 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. メッセージを表示するかどうかを決定する条件を追加する場合は、[ 条件 ] チェック ボックスをオンにします。

   

   条件には、 条件式、 フィルター、 ヒットカウントの 3 つの選択肢があります。

このメニューを使用すると、メッセージを出力ウィンドウに記録できます。 メッセージ ボックスに出力する文字列を入力します (引用符は必要ありません)。 変数の値を表示する場合は、中かっこで囲んでください。

たとえば、出力コンソールに counter 変数の値を表示する場合は、メッセージ テキスト ボックスに「 {counter} 」と入力します。

[ 閉じる ] をクリックし、プログラムをデバッグすると (F5)、出力ウィンドウに次の出力が表示されます。

特別なキーワードを使用して、より具体的な情報を表示することもできます。 次のようにキーワードを正確に入力します (各キーワードの前に "$" を使用し、キーワード自体のすべての大文字を使用します)。

条件式の場合、特定の条件が満たされた場合にのみ出力メッセージが表示されます。

条件式の場合は、特定の条件が true の場合、または変更されたときにメッセージを出力するようにトレースポイントを設定できます。 たとえば、 for ループの反復中にカウンターの値のみを表示する場合 は、[true ] オプションを選択し、メッセージ テキスト ボックスに「 i%2 == 0 」と入力します。

for ループの反復処理が変更されたときにカウンターの値を出力する場合は、[変更時] オプションを選択し、メッセージ テキスト ボックスに「i」と入力します。

[変更時] オプションの動作は、プログラミング言語によって異なります。

• ネイティブ コードの場合、デバッガーは条件の最初の評価を変更と見なさないため、最初の評価でトレースポイントにヒットしません。
• マネージド コードの場合、 変更時 が選択された後、デバッガーは最初の評価でトレースポイントをヒットします。

トレースポイントを有効にできる場合は、コードの特定のセクションにブレークポイントを挿入し、[ブレークポイントの設定] メニューの [ブレークポイントの設定] メニューの [次のブレークポイントにヒットした場合にのみ有効にする] チェック ボックスをオンにして、条件を設定することもできます。 選択肢の一覧から任意のブレークポイントを選択できます。

条件の設定中に使用できる有効な式の詳細については、「 デバッガーの式」を参照してください。

AI のサポートを受ける

Copilot がある場合は、トレースポイントの作成中に AI の支援を受けることができます。 Copilot には、コードに固有の 条件付きブレークポイント と トレースポイント の候補が表示されます。

詳細については、「 Copilot を使用したデバッグ」を参照してください。

ヒット カウント条件を使用すると、トレースポイントが設定されているコード行が指定された回数だけ実行された後にのみ出力を送信できます。

ヒットカウントの場合、トレースポイントが設定されているコード行が特定の回数実行されたときにメッセージを出力することを選択できます。 要件に基づいて、指定されたヒット カウント値と等しいか、または倍数であるか、または指定されたヒット カウント値以上である場合があります。 ニーズに最も適したオプションを選択し、目的のイテレーションを表す整数値をフィールド (5 など) に入力します。

また、最初のヒット時にブレークポイントを削除するには、[ヒット後に ブレークポイントを削除する] チェック ボックスをオンにします。

フィルター条件の場合は、表示されるデバイス、プロセス、またはスレッドの出力を指定します。

フィルター式の一覧:

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

文字列 (名前など) を二重引用符で囲みます。 値は引用符なしで入力できます。 句は、 & (AND)、 || (OR)、 ! (NOT)、かっこを使用して結合できます。