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

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

  • Статья

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

Примечание

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

Программа TextTransform.exe расположена в следующем каталоге:

\Program Files\Common Files\Microsoft Shared\TextTemplating\10.0

TextTransform [<options>] <templateName>

Параметры

Аргумент

Описание

templateName

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

Параметр

Описание

-out <имя_файла>

Файл, в который записываются выходные данные преобразования.

-r <сборка>

Сборка, используемая для компиляции и выполнения шаблона текста.

-u <пространство_имен>

Пространство имен, которое используется для компиляции шаблона.

-I <каталог_для_включения>

Каталог, содержащий текстовые шаблоны, включенные в указанный шаблон текста.

-P < путь_ссылки >

Каталог поиска для сборок, указанных в шаблоне текста, или для использования параметра -r.

Например, чтобы включить сборки, используемые для Visual Studio API, следует использовать

-P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"

-dp <processorName>!<className>!<assemblyName|codeBase>

Имя, полное имя типа и сборка процессора директивы, которые можно использовать для обработки пользовательских директивы в текстовом шаблоне.

-a [processorName]![directiveName]!<parameterName>!<parameterValue>

Предупреждающее замечаниеВнимание
Всегда вводите метки '!', даже опуская необязательные имена обработчика и директивы.Примеры. -a !!param!value

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

Для доступа к значениям параметров из процессора директив или текстового шаблона используйте ResolveParameterValue(String, String, String). В текстовом шаблоне включите hostspecific в директиву шаблона и вызовите сообщение на this.Host. Примеры.

<#@template language="c#" hostspecific="true"#>
[<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]

-h

Предоставляет справку.

Связанные разделы

Задача

Раздел

Создавайте файлы в решении Visual Studio.

Создание кода во время разработки с помощью текстовых шаблонов T4

Напишите обработчики директив для преобразования собственных источников данных.

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

Напишите текст шаблонов узла, который позволит вызывать текстовые шаблоны из собственного приложения.

Обработка текстовых шаблонов с помощью пользовательского хост-класса

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

Дата

Журнал

Причина

Июнь 2010

Добавлены сведения о параметре –a.

Обратная связь от клиента.