Microsoft.VisualStudio.TextTemplating-Namespace

Der Microsoft.VisualStudio.TextTemplating-Namespace stellt Klassen für die Textvorlagen-Transformationsfunktion bereit.Das Textvorlagen-Transformationsmodul ist in Visual Studio integriert und transformiert Textvorlagendateien in generierte Textausgabedateien.

Der Textvorlagen-Transformationsprozess erfordert eine Textvorlagendatei als Eingabe, führt die Transformation der Eingabe durch und generiert eine neue Textdatei als Ausgabe.Die Modulkomponente steuert den Prozess und interagiert mit einem Textvorlagen-Transformationshost und einer oder mehreren Textvorlagen-Direktivenprozessoren, um den Prozess abzuschließen.Weitere Informationen finden Sie unter Codegenerierung und T4-Textvorlagen.

Der Textvorlagen-Transformationsprozess umfasst zwei Schritte.Im ersten Schritt erstellt das Textvorlagen-Transformationsmodul eine Klasse, die als generierte Transformationsklasse bezeichnet wird.Im zweiten Schritt kompiliert das Modul die generierte Transformationsklasse und kompiliert sie, um die Textausgabe zu generieren.Die generierte Transformationsklasse besteht aus dem Code für die Textvorlage, das heißt, die Anweisungen, Ausdrücke, Klassenfunktionen, den Text mit Codebausteinen in der Textvorlage und den Ergebnissen, die durch das Aufrufen des Direktivenprozessors herbeigeführt wurden.Weitere Informationen finden Sie unter Schreiben einer T4-Textvorlage.

Fortgeschrittene Benutzer möchten einen eigenen Textvorlagen-Transformationsmodul-Host oder Direktivenprozessoren implementieren.Weitere Informationen finden Sie unter:

• Anpassen der T4-Texttransformation

• ITextTemplatingEngineHost

• DirectiveProcessor

• RequiresProvidesDirectiveProcessor

Klassen

	Klasse	Beschreibung
	AssemblyCacheMonitor	Überwacht den Status des Assemblycache.
	DirectiveProcessor	Die abstrakte Basisklasse für einen konkreten Direktivenprozessor.
	DirectiveProcessorException	Die Ausnahme, die vom Textvorlagen-Transformationsmodul ausgelöst wird, wenn beim Verarbeiten von Direktiven ein Fehler auftritt.
	EncodingHelper	Eine Hilfsklasse, die die Codierung einer Datei aus der Markierung für die Bytereihenfolge abruft.
	Engine	Das Textvorlagentransformations-Modul.
	ParameterDirectiveProcessor	Ein Direktivenprozessor, von dem einfache serialisierbare Parameter von Aufrufern oder dem Host an die Vorlage weitergeleitet werden.
	RequiresProvidesDirectiveProcessor	Die abstrakte Basisklasse für einen Direktivenprozessor, der das Entwurfsmuster zum Erfordern/Bereitstellen definiert und implementiert.
	TextTemplatingSession	Einfache Implementierung der Texttransformationssitzungs-Schnittstelle.
	TextTransformation	Die abstrakte Basisklasse für generierte Transformationsklassen.Diese Klasse stellt auch Dienstprogrammmethoden und -eigenschaften bereit, die in Textvorlagencode verwendet werden können.
	ToStringHelper	Eine Hilfsklasse, mit der eine kulturspezifische Darstellung eines Object als String erstellt wird.

Schnittstellen

	Schnittstelle	Beschreibung
	IRecognizeHostSpecific	Direktivenprozessoren implementieren diese Methode, um den Zustand des HostSpecific-Flags in einer Textvorlage abzurufen.
	ITextTemplatingEngine	Die Schnittstelle für das Textvorlagen-Transformationsmodul.
	ITextTemplatingEngineHost	Die Schnittstelle für den Host, der Textvorlagen transformiert.Dies ist für Direktivenprozessoren verfügbar und darauf kann auch von Textvorlagen zugegriffen werden.
	ITextTemplatingSession	Kann verwendet werden, um Informationen von einem Direktivenprozessor in eine Textvorlage zu senden.
	ITextTemplatingSessionHost	Wird von einem Textvorlagenhost implementiert und ermöglicht Aufrufern ein Objekt abzurufen, das die aktuelle Sitzung bezeichnet.Eine Sitzung stellt eine Reihe von Ausführungen von Textvorlagen dar.Mit dem Sitzungsobjekt können Informationen vom Host in den Code der Textvorlage übermittelt werden.