Compartir a través de


Generar archivos con la utilidad TextTransform

TextTransform.exe es una herramienta de la línea de comandos que puede utilizar para transformar una plantilla de texto. Al llamar a TextTransform.exe, especifique el nombre de un archivo de plantilla de texto como argumento. TextTransform.exe llama al motor de transformación de texto y procesa la plantilla de texto. A TextTransform.exe se le llama normalmente desde scripts. Sin embargo, no se requiere normalmente, porque puede realizar la transformación de texto en Visual Studio o en el proceso de compilación.

Nota

Si desea realizar la transformación de texto como parte de un proceso de compilación, considere utilizar la tarea de transformación de texto de MSBuild.Para obtener más información, vea Generación de código en un proceso de compilación.En una máquina en la que se instala Visual Studio, también puede escribir una aplicación o Extensión de Visual Studio que puede transformar plantillas de texto.Para obtener más información, vea Procesar las plantillas de texto mediante un host personalizado.

TextTransform.exe se encuentra en el directorio siguiente:

\Program Files\Common Files\Microsoft Shared\TextTemplating\11.0

TextTransform [<options>] <templateName>

Parámetros

Argumento

Descripción

templateName

Identifica el nombre del archivo de plantilla que desea transformar.

Opción

Descripción

-out <nombredearchivo>

El archivo en el que se escribe la salida de la transformación.

-r <assembly>

Un ensamblado utilizado para compilar y ejecutar la plantilla de texto.

-u <espaciodenombres>

Un espacio de nombres que se utiliza para compilar la plantilla.

-I <directorioinclusión>

Un directorio que contiene las plantillas de texto incluidas en la plantilla de texto especificada.

-P <rutadereferencia>

Un directorio para buscar los ensamblados especificados dentro de la plantilla de texto o para utilizar la opción -r.

Por ejemplo, para incluir ensamblados utilizados para la API de Visual Studio, use

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

-dp <nombreDeProcesador>!<nombreDeClase>!< nombreDeEnsamblado | códigoBase>

El nombre, nombre de tipo completo y ensamblado de un procesador de directivas que se puede utilizar para procesar directivas personalizadas dentro de la plantilla de texto.

-a [nombreDeProcesador]![nombreDeDirectiva]!<nombreDeParámetro>!<valorDeParámetro>

Advertencia

escriba siempre “!” marcas, aunque omite los nombres opcionales del procesador y de la directiva.Por ejemplo:

-a !!param!value

Especifique un valor de parámetro para un procesador de directivas. Si especifica solo el nombre y el valor del parámetro, este estará disponible para todos los procesadores de directivas. Si especifica un procesador de directivas, el parámetro solo estará disponible para el procesador especificado. Si especifica un nombre de directiva, el parámetro solo estará disponible cuando se procese la directiva especificada.

Para obtener acceso a los valores de parámetro de un procesador de directivas o una plantilla de texto, utilice ResolveParameterValue. En una plantilla de texto, incluya hostspecific en la directiva de plantilla e invoque el mensaje en this.Host. Por ejemplo:

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

-h

Proporciona ayuda.

Temas relacionados

Tarea

Tema

Genere archivos en una solución de Visual Studio.

Generación de código en tiempo de diseño usando las plantillas de texto T4

Escriba procesadores de directivas para transformar sus propios orígenes de datos.

Personalizar la transformación de texto T4

Escriba un host de plantilla de texto que permita invocar plantillas de texto desde su propia aplicación.

Procesar las plantillas de texto mediante un host personalizado