Problembehandlung bei T4-Textvorlagen

Fehler, die während der Transformation und Kompilierung der Textvorlage auftreten, werden in der gewohnten Weise in der Visual Studio-Fehlerliste gemeldet. In den meisten Fällen enthält der Fehlerbericht die Zeilennummern im Vorlagencode. Wenn der Fehlerbericht auf einen temporären Dateinamen verweist, ist dies in der Regel auf eine nicht übereinstimmende Klammer im Code der Textvorlage zurückzuführen.

Sie können den Code zum Debuggen von Fehlern, die während der Ausführung des Textvorlagencodes auftreten, schrittweise ausführen. Dazu müssen Sie der Vorlage zwei Zeilen hinzufügen:

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

  Wenn die Vorlage bereits eine template-Direktive enthält, legen Sie das debug-Attribut in dieser Direktive fest.

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

  Fügen Sie diesen Aufruf in der Nähe des Anfangs des Vorlagencodes ein. Bei der Ausführung des Codes erhalten Sie die Möglichkeit, die Vorlage mit einer neuen Visual Studio-Instanz zu debuggen. In dieser neuen Instanz können Sie den Vorlagencode mit der F10-TASTE schrittweise ausführen.

• Wenn Sie den Debugger später im Code erneut eingeben möchten, fügen Sie Folgendes ein:

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

Dieses Verfahren wird in den folgenden Themen detailliert beschrieben.

Exemplarische Vorgehensweise: Debuggen einer Textvorlage

Beschreibt das Debuggen einer Textvorlage.

Häufige Fehler und Warnungen beim Verwenden von Textvorlagen

Enthält eine Liste der allgemeinen Fehler und Warnungen, die im Fenster Fehlerliste in Visual Studio gemeldet werden.