Personalizar la transformación de texto T4Customizing T4 Text Transformation

Plantillas de texto son una característica de Visual StudioVisual Studio que le permiten generar código de programa u otros archivos de texto a través de un proceso de transformación.Text templates are a feature of Visual StudioVisual Studio that allow you to generate program code or other text files through a transformation process. Usar --- --- Visual Studio SDKVisual 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.Using --- --- Visual Studio SDKVisual Studio SDK, you can extend the default template transformation process by customizing the text template directive processor or the text template host.

En esta secciónIn This Section

El proceso de transformación de las plantillas de textoThe Text Template Transformation Process
Describe cómo funciona la transformación de texto y se explica el rol del host de plantilla y los procesadores de directivas.Describes how text transformation works, and explains the role of the template host and the directive processors.

Crear procesadores de directivas personalizadas para las plantillas de texto T4Creating Custom T4 Text Template Directive Processors
El procesador de directivas se ocupa de las directivas de la plantilla, como <#@template#>. se ejecuta durante la compilación de la plantilla y puede cargar ensamblados y otros recursos.The directive processor deals with directives in your template, such as <#@template#>. It runs during the compilation of the template, and can load assemblies and other resources. También puede insertar código que cargará los recursos en tiempo de ejecución.It can also insert code that will load resources at runtime. Al definir su propio procesador de directivas, puede reducir la complejidad de las plantillas.By defining your own directive processor, you can reduce the complexity of your templates.

Invocar la transformación de texto en una extensión de VSInvoking Text Transformation in a VS Extension
Si está escribiendo un Visual StudioVisual Studio extensión como un controlador de eventos o de comando de menú, la extensión puede utilizar el servicio de plantillas de texto para transformar una plantilla de texto.If you are writing a Visual StudioVisual Studio Extension such as a menu command or event handler, your extension can use the Text Templating Service to transform any text template. Puede pasar datos del parámetro en la plantilla mediante el objeto de sesión y obtener los valores desde dentro de la plantilla mediante el <#@parameter#> directiva.You can pass parameter data into the template by using the Session object, and get the values from within the template by using the <#@parameter#> directive.

Procesar las plantillas de texto mediante un host personalizadoProcessing Text Templates by using a Custom Host
Cuando se ejecuta el código de la plantilla de texto, el host proporciona acceso a archivos externos y el estado de la aplicación.When the code of the text template executes, the host provides access to external files and the state of the application. Por ejemplo, el host que ejecuta las transformaciones de texto en Visual StudioVisual Studio puede proporcionar acceso al explorador de soluciones.For example, the host that runs text transformations in Visual StudioVisual Studio can provide access to solution explorer. También muestra los errores en la ventana de mensaje de error.It also displays errors in the error message window. Si desea ejecutar transformaciones de texto en un contexto diferente, puede definir su propio host que proporciona acceso a los servicios disponibles en ese contexto.If you want to run text transformations in a different context, you can define your own host that provides access to the services available in that context.

Si está escribiendo un Visual StudioVisual Studio extensión, considere la posibilidad de utilizar el servicio de transformación de texto existente en lugar de escribir su propio host.If you are writing a Visual StudioVisual Studio Extension, consider using the existing text transformation service instead of writing your own host. Para obtener más información, consulte invocar la transformación de texto en una extensión de VS.For more information, see Invoking Text Transformation in a VS Extension.

ReferenciaReference

Escribir una plantilla de texto T4Writing a T4 Text Template

Proporciona la sintaxis de directivas de plantilla de texto y bloques de control.Provides the syntax of text template directives and control blocks.