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>
Precaución
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:
|
-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. |
|
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 |