Commentaires dans les modèles T4

Question

Cela semble être une question aussi fondamentale, mais je n'ai pas pu trouver un article MSDN ou une question StackOverflow qui y répond: est-il possible de faire des commentaires de ligne ou de bloquer les commentaires dans les modèles T4? Je ne cherche pas à générer du code avec des commentaires (c'est facile et simple) mais plutôt à commenter les blocs de mon balisage T4. Est-ce possible?

Answer 1

Pour inclure des commentaires dans le cadre du code de contrôle, ils doivent être à l'intérieur d'un bloc de code quelconque

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

ou

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

Parfois, vous avez besoin de pousser la balise de fermeture à la ligne suivante si vous êtes sensibles aux extra-retours à la ligne dans la sortie.

Si vous voulez faire des commentaires sur l'ensemble des blocs de balisage, il n'y a pas une solution simple et efficace, malheureusement, et le résultat est assez moche.

Vous pouvez le faire en échappant aux étiquettes que vous voulez commenter, comme suit:

\<# my control code \#>

et puis le plaçant à l'intérieur d'un commentaire dans un autre bloc comme ceci:

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

Answer 2

La meilleure façon d'ajouter un commentaire de bloc est d'utiliser #if et #endif

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