Compartir a través de


Microsoft.VisualStudio.TextTemplating (Espacio de nombres)

El espacio de nombres Microsoft.VisualStudio.TextTemplating proporciona clases para la funcionalidad de transformación de plantillas de texto.El motor de transformación de plantillas de texto está integrado en Visual Studio y transforma archivos de plantilla de texto en archivos de salida de texto generada.

El proceso de transformación de plantilla de texto toma un archivo de plantilla del texto como la entrada, lleva a cabo la transformación en la entrada y genera un nuevo archivo de texto como la salida.El componente de motor controla el proceso e interactúa con un host de transformación de plantilla de texto y uno o más procesadores de directivas de plantilla de texto para completar el proceso.Para obtener más información, vea Generación de código y plantillas de texto T4.

El proceso de transformación de plantilla de texto consta de dos pasos.En el primer paso, el motor de transformación de plantillas de texto crea una clase que se denomina la clase de transformación generada.En el segundo paso, el motor compila y ejecuta la clase de transformación generada, para producir la salida de texto generada.La clase de transformación generada consta del código de la plantilla de texto, es decir, las instrucciones, expresiones, características de clase y texto reutilizable en la plantilla de texto, y los resultados de llamar a los procesadores de directivas.Para obtener más información, vea Escribir una plantilla de texto T4.

Los usuarios avanzados podrían desear implementar su propio host de motor de transformación de plantillas de texto o procesadores de directivas.Para obtener más información, vea:

Clases

  Clase Descripción
Clase pública AssemblyCacheMonitor Supervisa el estado de la memoria caché de ensamblados.
Clase pública DirectiveProcessor Clase base abstracta de un procesador de directivas concreto.
Clase pública DirectiveProcessorAttribute
Clase pública DirectiveProcessorException Excepción producida por el motor de transformación de plantillas de texto, en caso de que se produzca un error durante el procesamiento de directivas.
Clase pública EncodingHelper Clase de utilidad que obtiene la codificación de un archivo a partir de su marca de orden de bytes.
Clase pública Engine Motor de transformación de plantillas de texto.
Clase pública ParameterDirectiveProcessor Procesador de directivas para enrutar parámetros serializables sencillos de los llamadores o el host a la plantilla.
Clase pública RequiresProvidesDirectiveProcessor Clase base abstracta de un procesador de directivas que define e implementa un modelo de diseño denominado requiere/proporciona.
Clase pública ServiceProviderExtensions Ordenar que contiene extensiones a IServiceProvider pertinente para las plantillas T4.
Clase pública ShadowCopyMonitor Supervisa el estado de ensamblados sombra- copiados que los host.
Clase pública SupportedDirectiveAttribute
Clase pública TextTemplatingSession Implementación trivial de la interfaz de sesión de transformación de texto.
Clase pública TextTransformation Clase base abstracta para todas las clases de transformación generadas.Esta clase también proporciona métodos y propiedades de utilidad para su uso en código de plantilla de texto.
Clase pública ToStringHelper Una clase de utilidad que se usa para generar la representación específica de la referencia cultural de Object como String.
Clase pública TransformedAllTemplatesEventArgs
Clase pública TransformingAllTemplatesEventArgs

Interfaces

  Interfaz Descripción
Interfaz pública IDebugTextTemplatingEngine
Interfaz pública IDebugTransformationRun
Interfaz pública IDebugTransformationRunFactory
Interfaz pública IDirectiveProcessor Interfaz para un procesador de directivas.
Interfaz pública IDirectiveProcessorMetadata Metadatos proporcionados por DirectiveProcessors.Los hosts que desea importar DPs mediante MEF pueden utilizar estos metadatos estándar.
Interfaz pública IRecognizeHostSpecific Los procesadores de directivas implementan este método para obtener el estado de la marca HostSpecific en una plantilla de texto.
Interfaz pública ITextTemplatingEngine Interfaz para el motor de transformación de plantillas de texto.
Interfaz pública ITextTemplatingEngineHost Interfaz para el host que transforma plantillas de texto.Está disponible para los procesadores de directivas y también pueden tener acceso a ella las plantillas de texto.
Interfaz pública ITextTemplatingOrchestrator
Interfaz pública ITextTemplatingSession Se puede usar para transmitir información de un procesador de directivas a una plantilla de texto.
Interfaz pública ITextTemplatingSessionHost Implementado por un host de plantillas de texto; permite a los llamadores obtener un objeto que indica la sesión actual.Una sesión representa series de ejecuciones de plantillas de texto.Se puede usar el objeto de sesión para pasar información del host al código de la plantilla de texto.