Директивы текстовых шаблонов T4

Директивы представляют собой инструкции для процессора преобразования текстового шаблона.

Синтаксис директив таков:

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

Все значения атрибутов должны заключаться в двойные кавычки. Если значение само содержит двойные кавычки, их нужно предварять знаком \.

Как правило, директивы — это первый элемент файла шаблона или включенного файла. Их не следует помещать внутри блока кода <#...#> или после блока функции класса <#+...#>.

• Директива Template T4

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

• Директива Parameter T4

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

• Директива Output T4

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

• Директива Assembly T4

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

• Директива Import T4

  <#@ import namespace="namespace" #>
  

• Директива Include T4

  <#@ include file="filePath" #>
  

Кроме того, можно создавать собственные директивы. Дополнительные сведения см. в разделе Создание пользовательских обработчиков директив для текстовых шаблонов. При использовании пакета SDK визуализации и моделирования для создания доменного языка (SDL) в составе доменного языка будет создан обработчик директив.

Журнал изменений

Дата	Журнал	Причина
Март 2011	Разделение материала по дочерним разделам.	Улучшение информации.
Июнь 2010	Использование $(SolutionDir) в директиве сборки. В предварительно обработанных шаблонах вместо этого нужно использовать ссылки на проект. Добавлен <#@Parameter#>. Добавлены сведения о наследовании и построении сборки, ссылка на которую содержится в шаблоне.	Обратная связь от клиента.