Share via

Настройка преобразования текста T4

  • Статья

Поддержка текстовых шаблонов – это функция Visual Studio, позволяющая генерировать программный или другие текстовые файлы посредством процесса преобразования.Используя SDK для Visual Studio, можно расширить используемый по умолчанию процесс преобразования шаблона, настроив процессор директив текстового шаблона или основное приложение текстового шаблона.

В этом подразделе

  • Процесс преобразования текстового шаблона
    Описано, как работает текстовое преобразование и какова роль основного приложения шаблона и процессоров директив.

  • Создание пользовательских обработчиков директив для текстовых шаблонов T4
    Процессор директив обрабатывает содержащиеся в шаблоне директивы, такие как директива <#@template#>. Он выполняется в процессе компиляции шаблона и может загружать сборки и другие ресурсы.Также он может вставлять код, загружающий ресурсы во время выполнения.Определив собственный процессор директив, можно уменьшить сложность шаблонов.

  • Вызов преобразования текста в расширении VS
    При создании расширения Visual Studio, такого как команда меню или обработчик событий, расширение может использовать службу текстовых шаблонов для преобразования любого текстового шаблона.Данные параметров можно передать в шаблон, воспользовавшись объектом "Сеанс", и получить значения из шаблона, воспользовавшись директивой <#@parameter#>.

  • Обработка текстовых шаблонов с помощью пользовательского хост-класса
    При выполнении кода текстового шаблона основное приложение предоставляет доступ ко внешним файлам и состоянию приложения.Например, основное приложение, выполняющее преобразование текста в Visual Studio, может предоставлять доступ к обозревателю решений.Также оно отображает окно с сообщениями об ошибках.Если требуется выполнить преобразования текста в другом контексте, можно определить собственное основное приложение, представляющее доступ к доступным в этом контексте службам.

    При создании расширения Visual Studio можно воспользоваться имеющейся службой преобразования текста, а не создавать собственный узел.Дополнительные сведения см. в разделе Вызов преобразования текста в расширении VS.

Ссылки

Написание текстового шаблона T4

Предоставляет синтаксис директив текстового шаблона и управляющие блоки.