T4 Text Template Directives

Directives provide instructions to the text template transformation engine.

The syntax of directives is as follows:

<#@ DirectiveName [AttributeName = "AttributeValue"] ... #>

All attribute values must be surrounded by double quotation marks. If the value itself contains quotation marks, they must be escaped with the \ character.

Directives are typically the first elements in a template file or an included file. You should not place them inside a code block <#...#>, nor after a class feature block <#+...#>.

T4 Template Directive

Copy

<#@ template [language="VB"] [hostspecific="true"] [debug="true"] [inherits="templateBaseClass"] [culture="code"] [compilerOptions="options"] #>

T4 Parameter Directive

Copy

<#@ parameter type="Full.TypeName" name="ParameterName" #>

T4 Output Directive

Copy

<#@ output extension=".fileNameExtension" [encoding="encoding"] #>

T4 Assembly Directive

Copy

<#@ assembly name="[assembly strong name|assembly file name]" #>

T4 Import Directive

Copy

<#@ import namespace="namespace" #>

T4 Include Directive

Copy

<#@ include file="filePath" #>

In addition, you can create your own directives. For more information, see Creating Custom Text Template Directive Processors. If you use the Visualization and Modeling SDK to create a domain-specific language (DSL), a directive processor will be generated as part of your DSL.