Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.

Command-Line Tools for Text Templates

By transforming a text template, you can generate text output such as code, HTML, and reports from a model. For more information, see Generating Artifacts By Using Text Templates.

Domain-Specific Language Tools provide two command-line tools that you can use to transform text templates:

  • TextTransform.exe

  • DslTextTransform.cmd

TextTransform.exe is a command-line tool that you can use to transform a text template. When you call TextTransform.exe, you specify the name of a text template file as an argument. TextTransform.exe calls the text transformation engine and processes the text template. For more information, see TextTransform.

TextTransform.exe is located in the following directory:

<root>\Program Files\Common Files\Microsoft Shared\Text Templating\1.2

DslTextTransform.cmd is a script that calls TextTransform.exe and runs it with common options. You can use DslTextTransformation.cmd to automate a nightly build of your Domain-Specific Language Tools projects.

DslTextTransform.cmd is located at:

<Visual Studio SDK Installation Path>\VisualStudioIntegration\Tools\Bin

You can specify the following arguments as input to DslTextTransform.cmd:

  • The output directory of the domain model project.

  • The output directory of the designer definition project.

  • The location of the text template file.

DslTextTransform.cmd processes the specified text template file using the default directive processors and assemblies (that is, those used with .dsldd, .dsldm, or .dslsetup). If you create custom directive processors, you can create your own batch file that calls TextTransform.exe (for example, CustomTextTransform.bat). In this batch file, you can specify your assemblies and the associated custom directive processors.

For more information, see Security of Text Templates.

Community Additions

© 2015 Microsoft