Compartir a través de


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 Visual Studio SDK, puede extender el proceso de transformación de plantillas predeterminado personalizando el procesador de directivas de plantilla de texto o el host de plantillas de texto.

En esta sección

  • El proceso de transformación de las plantillas de texto
    Describe cómo funciona la transformación de texto y explica el rol del host de plantilla y de los procesadores de directivas.

  • Crear procesadores de directivas personalizadas para las plantillas de texto T4
    El procesador de directivas trabaja con las directivas de la 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á recursos en tiempo de ejecución. Si define su propio procesador de directivas, puede reducir la complejidad de las plantillas.

  • Invocar la transformación de texto en una extensión de VS
    Si está escribiendo una extensión de Visual Studio como un comando de menú o controlador de eventos, la extensión puede utilizar el servicio de plantillas de texto para transformar cualquier plantilla de texto. Puede pasar los datos de parámetro en la plantilla mediante el objeto Session y obtener los valores desde dentro la plantilla utilizando la directiva <#@parameter#>.

  • Procesar las plantillas de texto mediante un host personalizado
    Cuando el código de la plantilla de texto se ejecuta, el host proporciona acceso a los archivos externos y el estado de la aplicación. Por ejemplo, el host que ejecuta las transformaciones de texto en Visual Studio puede proporcionar acceso a un explorador de soluciones. También muestra los errores en la ventana de mensajes 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 utilizar el servicio transformación de texto en lugar de escribir su propio host. Para obtener más información, vea Invocar la transformación de texto en una extensión de VS.

Referencia

Escribir una plantilla de texto T4

Proporciona la sintaxis de las directivas y los bloques de control de plantilla de texto.