Personalizar la transformación de texto T4

Las plantillas de texto son una característica de Visual Studio que permite generar código de programa u otros archivos de texto a través de un proceso de transformación. Con el SDK de Visual Studio, puede ampliar el proceso de transformación de plantillas predeterminado personalizando el procesador de directivas de plantilla de texto o el host de plantilla de texto.

En esta sección

Proceso de transformación de plantilla de texto Describe cómo funciona la transformación de texto y explica el rol del host de plantilla y los procesadores de directivas.

Creación de procesadores de directivas personalizadas para las plantillas de texto T4 El procesador de directivas se ocupa de las directivas de su plantilla, como <#@template#>.. Se ejecuta durante la compilación de la plantilla y puede cargar ensamblados y otros recursos. También puede insertar código que cargará los recursos en tiempo de ejecución. Al definir su propio procesador de directivas, puede reducir la complejidad de las plantillas.

Invocación de la transformación de texto en una extensión de VS Si va a escribir una extensión de Visual Studio, como un comando de menú o un controlador de eventos, la extensión puede usar el servicio de plantillas de texto para transformar cualquier plantilla de texto. Puede pasar datos de parámetros a la plantilla mediante el objeto de sesión y obtener los valores de la plantilla mediante la directiva <#@parameter#>.

Procesamiento de plantillas de texto mediante un host personalizado Cuando se ejecuta el código de la plantilla de texto, el host proporciona acceso a los archivos externos y al estado de la aplicación. Por ejemplo, el host que ejecuta transformaciones de texto en Visual Studio puede proporcionar acceso al Explorador de soluciones. También muestra errores en la ventana del mensaje de error. Si desea ejecutar transformaciones de texto en un contexto diferente, puede definir su propio host que proporcione acceso a los servicios disponibles en ese contexto.

Si está escribiendo una extensión de Visual Studio, considere la posibilidad de usar el servicio de transformación de texto existente en lugar de escribir su propio host. Para obtener más información, vea Invocación de transformación de texto en una extensión de VS.

Contenido relacionado

• Escritura de una plantilla de texto T4 proporciona la sintaxis de las directivas de plantilla de texto y los bloques de control.