Engine-Klasse

Artikel
07/20/2011

Das Textvorlagentransformations-Modul.

Vererbungshierarchie

System.Object
Microsoft.VisualStudio.TextTemplating.Engine

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

Syntax

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

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 Object und das aktuelle Object gleich sind. (Von Object geerbt.)
	Finalize	Ermöglicht es einem Objekt, zu versuchen, Ressourcen freizugeben und führt andere Bereinigungsvorgänge aus, bevor es von Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen besonderen Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	PreprocessTemplate	Generiert Code aus einer Vorlage, der bei der Kompilierung und Ausführung 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

Zum Seitenanfang

Hinweise

Der Textvorlagen-Transformationsprozess erfordert eine Textvorlagendatei als Eingabe und erzeugt eine neue Textdatei als Ausgabe. Die Textvorlagen-Transformationsmodul-Komponente steuert den Prozess und interagiert mit einem Textvorlagen-Transformationshost und einem oder mehreren Textvorlagendirektivenprozessoren, um den Prozess abzuschließen. 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.