Engine (Clase)

Artículo
11/02/2012

Motor de transformación de plantillas de texto.

Jerarquía de herencia

System.Object
Microsoft.VisualStudio.TextTemplating.Engine

Espacio de nombres: Microsoft.VisualStudio.TextTemplating
Ensamblado: Microsoft.VisualStudio.TextTemplating.11.0 (en Microsoft.VisualStudio.TextTemplating.11.0.dll)

Sintaxis

'Declaración
Public Class Engine _
    Implements IDebugTextTemplatingEngine, ITextTemplatingEngine

public class Engine : IDebugTextTemplatingEngine, ITextTemplatingEngine

public ref class Engine : IDebugTextTemplatingEngine, ITextTemplatingEngine

type Engine =  
    class
        interface IDebugTextTemplatingEngine
        interface ITextTemplatingEngine
    end

public class Engine implements IDebugTextTemplatingEngine, ITextTemplatingEngine

El tipo Engine expone los siguientes miembros.

Constructores

	Nombre	Descripción
	Engine	Inicializa una nueva instancia de la clase Engine.

Arriba

Métodos

	Nombre	Descripción
	Equals	Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	PrepareTransformationRun	Prepara un objeto de IDebugTransformationRun para ejecutar la plantilla.
	PreprocessTemplate	Genera código de una plantilla que, cuando se compila y se ejecuta, genere la salida de la plantilla.
	ProcessTemplate	Transforma el contenido de un archivo de plantilla del texto para producir el resultado de texto generado.
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Campos

	Nombre	Descripción
	CacheAssembliesOptionString	Cadena de la opción de CacheAssemblies.
	TemplateFileParameterName

Arriba

Comentarios

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

Sugerencia
Si está escribiendo una extensión o paquete que se ejecutan dentro de Visual Studio, considere utilizar el servicio de plantillas 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.

Ejemplos

En el ejemplo siguiente se muestra cómo se crea una instancia de Engine y se llama a ProcessTemplate para transformar una plantilla de texto.

Este ejemplo de código forma parte de un ejemplo más extenso relativo a la interfaz ITextTemplatingEngineHost.

Engine engine = new Engine();

//read the text template
string input = File.ReadAllText(templateFileName);

//transform the text template
string output = engine.ProcessTemplate(input, host);

Dim engine As Engine = New Engine()

'read the text template
Dim input As String = File.ReadAllText(templateFileName)

'transform the text template
Dim output As String = engine.ProcessTemplate(input, host)

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.