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:
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. |