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:

• Personalizar la transformación de texto T4

• ITextTemplatingEngineHost

• DirectiveProcessor

• RequiresProvidesDirectiveProcessor

Clases

	Clase	Descripción
	AssemblyCacheMonitor	Supervisa el estado de la memoria caché de ensamblados.
	DirectiveProcessor	Clase base abstracta de un procesador de directivas concreto.
	DirectiveProcessorAttribute
	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.
	EncodingHelper	Clase de utilidad que obtiene la codificación de un archivo a partir de su marca de orden de bytes.
	Engine	Motor de transformación de plantillas de texto.
	ParameterDirectiveProcessor	Procesador de directivas para enrutar parámetros serializables sencillos de los llamadores o el host a la plantilla.
	RequiresProvidesDirectiveProcessor	Clase base abstracta de un procesador de directivas que define e implementa un modelo de diseño denominado requiere/proporciona.
	ServiceProviderExtensions	Ordenar que contiene extensiones a IServiceProvider pertinente para las plantillas T4.
	ShadowCopyMonitor	Supervisa el estado de ensamblados sombra- copiados que los host.
	SupportedDirectiveAttribute
	TextTemplatingSession	Implementación trivial de la interfaz de sesión de transformación de texto.
	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.
	ToStringHelper	Una clase de utilidad que se usa para generar la representación específica de la referencia cultural de Object como String.
	TransformedAllTemplatesEventArgs
	TransformingAllTemplatesEventArgs

Interfaces

	Interfaz	Descripción
	IDebugTextTemplatingEngine
	IDebugTransformationRun
	IDebugTransformationRunFactory
	IDirectiveProcessor	Interfaz para un procesador de directivas.
	IDirectiveProcessorMetadata	Metadatos proporcionados por DirectiveProcessors.Los hosts que desea importar DPs mediante MEF pueden utilizar estos metadatos estándar.
	IRecognizeHostSpecific	Los procesadores de directivas implementan este método para obtener el estado de la marca HostSpecific en una plantilla de texto.
	ITextTemplatingEngine	Interfaz para el motor de transformación de plantillas de texto.
	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.
	ITextTemplatingOrchestrator
	ITextTemplatingSession	Se puede usar para transmitir información de un procesador de directivas a una plantilla de texto.
	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.