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 <#+...#>.
-
<#@ template [language="VB"] [hostspecific="true"] [debug="true"] [inherits="templateBaseClass"] [culture="code"] [compilerOptions="options"] #>
-
<#@ parameter type="Full.TypeName" name="ParameterName" #>
-
<#@ output extension=".fileNameExtension" [encoding="encoding"] #>
-
<#@ assembly name="[assembly strong name|assembly file name]" #>
-
<#@ import namespace="namespace" #>
-
<#@ 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.
Change History
Date |
History |
Reason |
---|---|---|
March 2011 |
Split content into child topics. |
Information enhancement. |
June 2010 |
Use $(SolutionDir) in assembly directive. In preprocessed templates, use project references instead. Added <#@Parameter#>. Added notes on inherits, and building an assembly that you refer to in a template. |
Customer feedback. |