Share via


T4 テキスト テンプレートのトラブルシューティング

テキスト テンプレートの変換中およびコンパイル中に発生するエラーは、Visual Studio のエラー一覧に通常の方法で報告されます。 ほとんどの場合、エラー報告には、テンプレート コード内の行番号が表示されます。 エラー報告が一時ファイル名を指している場合は、一般的な原因として、テキスト テンプレートのコードで使用されている角かっこの対応関係が正しくない可能性があります。

テキスト テンプレート コードの実行中に発生したエラーは、コードをステップ実行することによってデバッグできます。 そのためには、次の 2 つの行をテンプレートに追加します。

  • <#@template debug="true"#>

    テンプレートに既に template ディレクティブが存在する場合は、そのディレクティブ内で debug 属性を設定します。

  • <# System.Diagnostics.Debugger.Launch(); #>

    この呼び出しは、テンプレート コードの先頭付近に挿入します。 これを実行すると、Visual Studio の新しいインスタンスを使用してテンプレートをデバッグできます。 この新しいインスタンスで、F10 キーを使用しながら、テンプレート コードをステップ実行できます。

  • 後でコードにデバッガーを再入力する場合は、次の行を挿入します。

    <# System.Diagnostics.Debugger.Break(); #>

この手順は、次のトピックで詳しく説明されています。

チュートリアル: テキスト テンプレートのデバッグ

テキスト テンプレートのデバッグ方法を説明します。

テキスト テンプレートの使用時によく発生するエラーと警告

Visual Studio の [エラー一覧] ウィンドウで最も多く報告されるエラーと警告の一覧を示します。