Personalización de 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 predeterminada personalizando el procesador de directivas de plantilla de texto o el host de plantilla de texto.

En esta sección

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

Crear procesadores de directivas de plantilla de texto T4 personalizados: El procesador de directivas maneja directivas en tu plantilla, tales como <#@template#>.. Se ejecuta durante la compilación de la plantilla y puede cargar bibliotecas de ensamblado 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.

Invocar la transformación de texto en una extensión de Visual Studio: si está escribiendo 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 Session y obtener los valores de dentro de la plantilla mediante la <#@parameter#> directiva .

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 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 va a escribir 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, consulte Invocación de transformación de texto en una extensión de VS.

Contenido relacionado

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