Создание файлов с помощью служебной программы TextTransform
TextTransform.exe – это программа командной строки, которую можно использовать для преобразования шаблона текста.При вызове TextTransform.exe укажите имя файла шаблона текста в качестве аргумента.TextTransform.exe вызывает обработчик преобразования текста и обрабатывает шаблон текста.TextTransform.exe обычно вызывается из скриптов.Однако обычно это необходимо, поскольку можно выполнить преобразование текста или в Visual Studio или в процессе построения.
.gif "Примечание") Примечание |
|---|
Если требуется выполнить преобразование текста в рамках процесса построения, следует рассмотреть возможность использования задачи преобразования текста MSBuild.Дополнительные сведения см. в разделе Создание кода в процессе построения.На компьютере, на котором имеется Visual Studio, можно также написать приложение или расширение Visual Studio, которое может выполнять преобразование шаблонов текста.Дополнительные сведения см. в разделе Обработка текстовых шаблонов с помощью пользовательского хост-класса. |
Программа TextTransform.exe расположена в следующем каталоге:
\Program Files\Common Files\Microsoft Shared\TextTemplating\11.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> .gif "Предупреждающее замечание") Внимание
Всегда введите "!" метки, даже если необязательный процессора и директивные имена.Примеры. -a !!param!value
|
Укажите значение параметра для процессора директив.Если указать имя параметра и значение, то параметр будет доступен для всех процессоров директив.Если указывается имя процессора директив, то параметр будет доступен только для указанного процессора.Если указывается имя директивы, то параметр будет доступен только при обработке указанной директивы. Для доступа к значениям параметров из процессора директив или текстового шаблона используйте ResolveParameterValue.В текстовом шаблоне включите hostspecific в директиву шаблона и вызовите сообщение на this.Host.Примеры. |
-h |
Предоставляет справку. |
См. также
Задача |
Раздел |
|---|---|
Создавайте файлы в решении Visual Studio. |
Создание кода во время разработки с помощью текстовых шаблонов T4 |
Напишите обработчики директив для преобразования собственных источников данных. |
|
Напишите текст шаблонов узла, который позволит вызывать текстовые шаблоны из собственного приложения. |
Обработка текстовых шаблонов с помощью пользовательского хост-класса |