疑難排解 T4 文字範本

Visual Studio 錯誤清單會以一般方式報告轉換和編譯文字範本時發生的錯誤。 在大部分情況下,錯誤報告會提供範本程式碼中出現錯誤的行號。 當錯誤報告提到暫存檔案名稱時,通常是因為文字範本程式碼中的括弧不對稱所致。

若要偵錯執行中文字範本程式碼所發生的錯誤,您可以逐步執行程式碼。 若要這麼做,必須在範本中加入兩行程式碼:

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

    如果範本已經包含 template 指示詞,請在該指示詞中設定 debug 屬性。

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

    在範本程式碼開頭附近插入上述呼叫。 執行此呼叫時,就會要求您使用 Visual Studio 的新執行個體來偵錯範本。 在這個新執行個體中,您可以使用 F10 鍵來逐步執行範本程式碼。

  • 如果之後要在程式碼中重新輸入偵測工具,請插入:

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

下列主題將詳細描述這個程序。

逐步解說:偵錯文字範本

會說明如何偵錯文字範本。

使用文字範本的常見錯誤和警告

會列出 Visual Studio 中最常透過 [錯誤清單] 視窗報告的錯誤和警告。