Classe Engine

Articolo
10/30/2012

Il motore di trasformazione del modello di testo.

Gerarchia di ereditarietà

System.Object
Microsoft.VisualStudio.TextTemplating.Engine

Spazio dei nomi: Microsoft.VisualStudio.TextTemplating
Assembly: Microsoft.VisualStudio.TextTemplating.11.0 (in Microsoft.VisualStudio.TextTemplating.11.0.dll)

Sintassi

'Dichiarazione
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

Il tipo Engine espone i seguenti membri.

Costruttori

	Nome	Descrizione
	Engine	Inizializza una nuova istanza della classe Engine.

In alto

Metodi

	Nome	Descrizione
	Equals	Determina se l'oggetto specificato equivale all'oggetto corrente. (Ereditato da Object)
	Finalize	Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
	GetHashCode	Funge da funzione hash per un determinato tipo. (Ereditato da Object)
	GetType	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
	MemberwiseClone	Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
	PrepareTransformationRun	Rende un oggetto di IDebugTransformationRun eseguire il modello.
	PreprocessTemplate	Genera codice da un modello che, quando viene compilato ed eseguito, verrà generato l'output del modello.
	ProcessTemplate	Trasforma il contenuto di un file modello di testo per produrre l'output di testo generato.
	ToString	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

In alto

Campi

	Nome	Descrizione
	CacheAssembliesOptionString	Stringa di opzione di CacheAssemblies.
	TemplateFileParameterName

In alto

Note

Il processo di trasformazione del modello di testo viene preso un file modello di testo come input e produce un nuovo file di testo come output.Il componente del motore di trasformazione del modello di testo controlla il processo e l'interazione con un host di trasformazione del modello di testo e uno o più processori di direttiva del modello di testo per completare il processo.Per ulteriori informazioni, vedere Generazione di codice e modelli di testo T4.

Suggerimento
Se si scrive un pacchetto o un'estensione che verrà eseguita in Visual Studio, si consiglia di utilizzare il servizio del modello di testo anziché scrivere un proprio host.Per ulteriori informazioni, vedere Richiamo della trasformazione del testo in un'estensione VS.

Esempi

Nell'esempio riportato di seguito viene illustrato come creare un'istanza dell'oggetto Engine chiamando il metodo ProcessTemplate per la trasformazione di un modello di testo.

Questo esempio di codice fa parte di un esempio più esaustivo fornito per l'interfaccia 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)