Поделиться через

Директива Include T4

  • Статья

В текстовый шаблон в Visual Studio можно включить текст из другого файла, воспользовавшись директивой <#@include#>.Директивы include можно разместить в любом месте текстового шаблона перед первым блоком функций класса <#+ ... #>.Включенные файлы также могут содержать директивы include и другие директивы.Это позволяет использовать один и тот же код шаблона и стандартный текст в нескольких шаблонах.

Использование директив Include

<#@ include file="filePath" #>

  • Путь filePath может быть абсолютным или относительным для текущего файла шаблона.

    Кроме того, отдельные расширения Visual Studio могут задавать собственные каталоги для поиска включенных файлов.Например, при установке пакета Visualization and Modeling SDK (DSL Tools) в список включения добавляется следующая папка: Program Files\Microsoft Visual Studio 10.0\Common7\IDE\Extensions\Microsoft\DSL SDK\DSL Designer\11.0\TextTemplates.

    Эти дополнительные папки включения могут зависеть от расширения включающего файла.Например, папка включения DSL Tools доступна только для включающих файлов с расширением .tt.

  • filePath может включать переменные среды, отделенные знаком "%".Примеры.

    <#@ include file="%HOMEPATH%\MyIncludeFile.t4" #>

  • Имя включенного файла не нужно использовать расширение ".tt".

    Требуется использовать другое расширение, например ".t4" для включения файлов.Это объясняется тем, что при добавлении файла .tt в проект Visual Studio автоматически задает для свойства Специальный инструмент значение TextTemplatingFileGenerator.Как правило, не нужно, чтобы включенные файлы преобразовывались по отдельности.

    С другой стороны, нужно помнить, что в некоторых случаях расширение файла влияет на то, в каких дополнительных папках будет выполнен поиск файлов включения.Это может оказаться важным при наличии включенного файла, содержащего другие файлы.

  • Включенное содержимое обрабатывается почти так же, как если бы оно было часть включающего текстового шаблона.Однако можно включить файл, содержащий блок функций класса <#+...#>, даже если за директивой include следуют обычный текст и стандартные управляющие блоки.

MyTextTemplate.tt:

<#@ output extension=".txt" #>
Output message 1 (from top template).
<#@ include file="TextFile1.t4"#>
Output message 5 (from top template).
<#
   GenerateMessage(6); // defined in TextFile1.t4
   AnotherGenerateMessage(7); // defined in TextFile2.t4
#>

TextFile1.t4:

   Output Message 2 (from included file).
<#@include file="TextFile2.t4" #>
   Output Message 4 (from included file).
<#+ // Start of class feature control block.
void GenerateMessage(int n)
{
#>
   Output Message <#= n #> (from GenerateMessage method).
<#+
}
#>

TextFile2.t4:

        Output Message 3 (from included file 2).
<#+ // Start of class feature control block.
void AnotherGenerateMessage(int n)
{
#>
       Output Message <#= n #> (from AnotherGenerateMessage method).
<#+
}
#>

Сгенерированный в результате файл, MyTextTemplate.txt:

Output message 1 (from top template).
   Output Message 2 (from included file).
        Output Message 3 (from included file 2).

   Output Message 4 (from included file).

Output message 5 (from top template).
   Output Message 6 (from GenerateMessage method).
       Output Message 7 (from AnotherGenerateMessage method).