Создание файлов с помощью служебной программы TextTransform

TextTransform.exe — это средство командной строки, которое можно использовать для преобразования текстового шаблона. При вызове TextTransform.exeукажите имя текстового файла шаблона в качестве аргумента. TextTransform.exe вызывает обработчик преобразования текста и обрабатывает текстовый шаблон. TextTransform.exe обычно вызывается из скриптов. Однако обычно это не обязательно, так как можно выполнять преобразование текста в Visual Studio или в процессе сборки.

Замечание

Если вы хотите выполнить преобразование текста в процессе сборки, рассмотрите возможность использования задачи преобразования текста MSBuild. Дополнительные сведения см. в разделе "Создание кода" в процессе сборки. На компьютере, на котором установлена Visual Studio, можно также написать приложение или расширение Visual Studio, которое может преобразовывать текстовые шаблоны. Дополнительные сведения см. в разделе "Обработка текстовых шаблонов" с помощью пользовательского узла.

TextTransform.exe находится в следующем каталоге:

Синтаксис

TextTransform [<options>] <templateName>

Параметры

Argument	Описание
templateName	Определяет имя файла шаблона, который требуется преобразовать.

Выбор	Описание
-out<имя файла>	Файл, в который записываются выходные данные преобразования.
-r<сборка>	Сборка, используемая для компиляции и запуска текстового шаблона.
-u<пространство имен>	Пространство имен, используемое для компиляции шаблона.
-Я<includedirectory>	Каталог, содержащий текстовые шаблоны, включенные в указанный текстовый шаблон.
-P<referencepath>	Каталог для поиска сборок, указанных в текстовом шаблоне или для использования параметра -r . Например, чтобы включить сборки, используемые в API Visual Studio, используйте -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<processorName>!<className>!<assemblyName|codeBase>	Имя, полное имя типа и сборка обработчика директив, которые можно использовать для обработки пользовательских директив в текстовом шаблоне.
-a [processorName]![название директивы]!<имя параметра>!<значение параметра>	Укажите значение параметра для обработчика директив. Если указать только имя и значение параметра, параметр будет доступен для всех процессоров директив. Если указать обработчик директив, параметр доступен только указанному обработчику. Если указать имя директивы, параметр доступен только при обработке указанной директивы. Чтобы получить доступ к значениям параметров из обработчика директив или текстового шаблона, используйте ITextTemplatingEngineHost.ResolveParameterValue. В текстовом шаблоне включите hostspecific в директиву шаблона и вызовите сообщение this.Host. Рассмотрим пример. <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]. Всегда вводите знаки '!', даже если вы опустите необязательные имена процессора и директив. Рассмотрим пример. -a !!param!value
-h	Предоставляет справку.

Связанный контент

• создание кодаDesign-Time с помощью текстовых шаблонов T4
• Настройка преобразования текста T4
• Обработка текстовых шаблонов с помощью пользовательского узла