Classe Engine

Articolo
08/11/2011

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.10.0 (in Microsoft.VisualStudio.TextTemplating.10.0.dll)

Sintassi

'Dichiarazione
Public Class Engine _
    Implements ITextTemplatingEngine

public class Engine : ITextTemplatingEngine

public ref class Engine : ITextTemplatingEngine

type Engine =  
    class
        interface ITextTemplatingEngine
    end

public class Engine implements 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 Object specificato è uguale all'oggetto Object 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)
	PreprocessTemplate	Generare codice da un modello che, quando compilato ed eseguito, produrrà 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

In alto

Note

Il processo di trasformazione del modello di testo riceve un file di 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 interagisce con un host di trasformazione del modello di testo e con 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, anziché scrivere il proprio host, è consigliabile utilizzare il servizio del modello di testo. Per ulteriori informazioni, vedere Invoking Text Transformation in a Visual Studio Extension.

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)