Engine-Klasse

Artikel
05/16/2015

Das Textvorlagentransformations-Modul.

Vererbungshierarchie

Object
Microsoft.VisualStudio.TextTemplating.Engine

Namespace: Microsoft.VisualStudio.TextTemplating
Assembly: Microsoft.VisualStudio.TextTemplating.12.0 (in Microsoft.VisualStudio.TextTemplating.12.0.dll)

Syntax

'Declaration
Public Class Engine _
    Implements ITextTemplatingEngine, IDebugTextTemplatingEngine

public class Engine : ITextTemplatingEngine, IDebugTextTemplatingEngine

public ref class Engine : ITextTemplatingEngine, IDebugTextTemplatingEngine

type Engine =  
    class 
        interface ITextTemplatingEngine 
        interface IDebugTextTemplatingEngine 
    end

public class Engine implements ITextTemplatingEngine, IDebugTextTemplatingEngine

Der Engine-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	Engine	Initialisiert eine neue Instanz der Engine-Klasse.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Fungiert als die Standardhashfunktion. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie vom aktuellen Object. (Von Object geerbt.)
	PrepareTransformationRun	Bereitet ein IDebugTransformationRun-Objekt vor, die Vorlage durchzuführen.
	PreprocessTemplate	Generiert Code von einer Vorlage, die, wenn sie kompiliert und ausgeführt wird, die Vorlagenausgabe erzeugt.
	ProcessTemplate	Transformiert den Inhalt einer Textvorlagendatei, um die generierte Textausgabe zu erzeugen.
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Felder

	Name	Beschreibung
	CacheAssembliesOptionString	CacheAssemblies-Optionszeichenfolge.
	TemplateFileParameterName

Zum Seitenanfang

Hinweise

Der Textvorlagen-Transformationsprozess wird aus einer Textvorlagendatei (Eingabe) eine neue Textdatei (Ausgabe) erzeugt. Die Textvorlagen-Transformationsmodul-Teiltriebwerk-bedienanlagen der Prozess und interagiert mit einem Textvorlagen-Transformationshost und einem oder mehreren Textvorlagen-Direktivenprozessoren, um den Prozess auszuführen. Weitere Informationen finden Sie unter Codegenerierung und T4-Textvorlagen.

Tipp

Wenn Sie ein Paket oder eine Erweiterung schreiben, die in Visual Studio ausgeführt wird, verwenden Sie, ggf. den Textvorlagendienst, anstatt, einen eigenen Host zu schreiben.Weitere Informationen finden Sie unter Aufrufen von Texttransformation in einer VS-Erweiterung.

Beispiele

Im folgenden Beispiel wird das Erstellen einer Instanz des Engine-Elements und Aufrufen des ProcessTemplate-Elements veranschaulicht.

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die ITextTemplatingEngineHost-Schnittstelle.

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)

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.