Комментарии в шаблонах T4

Question

Это похоже на такой основной вопрос, но я не смог найти статью MSDN или вопрос StackOverflow, на который он отвечает: возможно ли сделать строчные комментарии или заблокировать комментарии в шаблонах T4? Я не собираюсь генерировать код с комментариями (это легко и просто), а закомментирую блоки моей разметки T4. Это возможно?

Answer 1

Чтобы включить комментарии как часть управляющего кода, они должны быть внутри какого-то блока кода

<# // Hello this is a comment #> for example

или

<#+ // Hello this is a comment in a class feature block #>

Иногда вам нужно нажать на тег закрытияна следующую строку, если вы чувствительны к дополнительным символам новой строки в выводе.

Если вы хотите закомментировать целые блоки разметки, к сожалению, не существует простого решения, и результат становится довольно уродливым.

Вы можете сделать это, экранируя теги, которые вы хотели бы прокомментировать, например:

\<# my control code \#>

, а затем поместив это внутри комментария в другой блок, например:

<# // \<# my control code \#> #>

Answer 2

Лучший способ добавить комментарий к блоку - использовать #if и # endif

<#
   #if false
   foreach(var typeName in typeNames)
   { 
       var className = typeName + "Adapter";
#>
    // ...
<#  
    }
    #endif
#>