Dépannage des modèles de texte T4

Les erreurs qui surviennent lors de la transformation et de la compilation du modèle de texte sont signalées dans la liste d'erreurs Visual Studio de la façon habituelle. Dans la plupart des cas, les numéros de ligne du code du modèle sont indiqués dans le rapport d'erreurs. Lorsque le rapport d'erreurs fait référence à un nom de fichier temporaire, cela est généralement dû à la présence d'un crochet non apparié dans le code du modèle de texte.

Pour déboguer les erreurs qui se produisent lors de l'exécution du code du modèle de texte, vous pouvez exécuter le code pas à pas. Pour ce faire, vous devez ajouter deux lignes à votre modèle :

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

  Si le modèle contient déjà une directive template, définissez l'attribut debug dans cette directive.

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

  Insérez cet appel au début du code du modèle. Lors de son exécution, vous serez invité à déboguer le modèle à l'aide d'une nouvelle instance de Visual Studio. Dans cette nouvelle instance, vous pouvez exécuter pas à pas le code du modèle à l'aide de la touche F10.

• Si vous souhaitez accéder de nouveau au débogueur ultérieurement dans le code, insérez :

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

Cette procédure est décrite de manière plus détaillée dans les rubriques suivantes.

Procédure pas à pas : débogage d'un modèle de texte

Décrit comment déboguer un modèle de texte.

Erreurs et avertissements courants lors de l'utilisation de modèles de texte

Répertorie les erreurs et avertissements les plus courants qui sont signalés via la fenêtre Liste d'erreurs de Visual Studio.