Compartir vía

Generación de archivos con la utilidad TextTransform

TextTransform.exe es una herramienta de línea de comandos que puede usar 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. TextTransform.exe normalmente se llama desde scripts. Sin embargo, no suele ser necesario, ya que 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 la posibilidad de usar 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 un equipo en el que está instalado Visual Studio, también puede escribir una aplicación o una extensión de Visual Studio que pueda transformar plantillas de texto. Para obtener más información, consulte Procesamiento de plantillas de texto mediante un host personalizado.

TextTransform.exe se encuentra en el directorio siguiente:

Syntax

TextTransform [<options>] <templateName>

Parámetros

Argumento Descripción
templateName Identifica el nombre del archivo de plantilla que desea transformar.
Opción Descripción
-out<nombre> Archivo en el que se escribe la salida de la transformación.
-r<ensamblaje> Ensamblado usado para compilar y ejecutar la plantilla de texto.
-u<Namespace> Espacio de nombres que se usa para compilar la plantilla.
-I<includedirectory> Directorio que contiene las plantillas de texto incluidas en la plantilla de texto especificada.
-P<ruta de referencia> Directorio para buscar ensamblados especificados en la plantilla de texto o para usar la opción -r .

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

-P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-Dp<processorName>!<className>!<assemblyName|codeBase> El nombre, el nombre de tipo completo y el ensamblado de un procesador de directivas que se puede usar para procesar directivas personalizadas dentro de la plantilla de texto.
-a [processorName]![directiveName]!<parameterName>!<parameterValue> Especifique un valor de parámetro para un procesador de directivas. Si especifica solo el nombre y el valor del parámetro, el parámetro estará disponible para todos los procesadores de directivas. Si especifica un procesador de directivas, el parámetro solo está disponible para el procesador especificado. Si especifica un nombre de directiva, el parámetro solo está disponible cuando se procesa la directiva especificada.

Para acceder a los valores de parámetro desde un procesador de directivas o una plantilla de texto, use ITextTemplatingEngineHost.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") #>].

Escriba siempre las marcas '!', incluso si se omiten los nombres de directiva y procesador opcionales. Por ejemplo:

-a !!param!value
-h Proporciona ayuda.

Contenido relacionado

  • Last updated on