Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Textvorlagentransformationsprozess verwendet eine Textvorlagendatei als Eingabe und erzeugt eine Textdatei als Ausgabe. Sie können das Texttransformationsmodul aus einer Visual Studio-Erweiterung oder aus einer eigenständigen Anwendung aufrufen, die auf einem Computer ausgeführt wird, auf dem Visual Studio installiert ist. Sie müssen jedoch einen Textvorlagen-Host angeben. Diese Klasse verbindet die Vorlage mit der Umgebung, indem sie Ressourcen wie Assemblies und Include-Dateien findet und die Ausgabe sowie Fehlermeldungen behandelt.
Tipp
Wenn Sie ein Paket oder eine Erweiterung schreiben, das in Visual Studio ausgeführt wird, sollten Sie den Text templating-Dienst verwenden, anstatt Ihren eigenen Host zu schreiben. Weitere Informationen finden Sie unter "Aufrufen der Texttransformation in einer VS-Erweiterung".
Hinweis
Es wird nicht empfohlen, Textvorlagentransformationen in Serveranwendungen zu verwenden. Es wird nicht empfohlen, Textvorlagentransformationen außer in einem einzelnen Thread zu verwenden. Dies liegt daran, dass das Textvorlagenmodul eine einzelne AppDomain zum Übersetzen, Kompilieren und Ausführen von Vorlagen verwendet. Der übersetzte Code ist nicht für Thread-Sicherheit entworfen. Die Engine ist für die serielle Verarbeitung von Dateien konzipiert, so wie sie zur Entwicklungszeit in einem Visual Studio-Projekt vorhanden sind.
Für Laufzeitanwendungen sollten Sie die Verwendung vorverarbeiteter Textvorlagen in Betracht ziehen: Siehe Run-Time Textgenerierung mit T4-Textvorlagen.
Wenn Ihre Anwendung eine Reihe von Vorlagen verwendet, die zur Kompilierungszeit festgelegt sind, ist es einfacher, Vorverarbeitete Textvorlagen zu verwenden. Sie können diesen Ansatz auch verwenden, wenn Ihre Anwendung auf einem Computer ausgeführt wird, auf dem Visual Studio nicht installiert ist. Weitere Informationen finden Sie unter Run-Time Textgenerierung mit T4-Textvorlagen.
Ausführen einer Textvorlage in Ihrer Anwendung
Zum Ausführen einer Textvorlage rufen Sie die ProcessTemplate-Methode von Microsoft.VisualStudio.TextTemplating.Engine:
using Microsoft.VisualStudio.TextTemplating;
...
Engine engine = new Engine();
string output = engine.ProcessTemplate(templateString, host);
Ihre Anwendung muss die Vorlage finden und bereitstellen und mit der Ausgabe umgehen.
host Im Parameter müssen Sie eine Klasse bereitstellen, die ITextTemplatingEngineHost implementiert. Dies wird vom Engine rückgerufen.
Der Host muss Fehler protokollieren, Verweise auf Assembly beheben und Dateien einschließen, eine Anwendungsdomäne bereitstellen, in der die Vorlage ausgeführt werden kann, und den entsprechenden Prozessor für jede Direktive aufrufen.
Microsoft.VisualStudio.TextTemplating.Engine ist in Microsoft.VisualStudio.TextTemplating.*.0.dlldefiniert, und ITextTemplatingEngineHost ist in Microsoft.VisualStudio.TextTemplating.Interfaces.*.0.dlldefiniert.
In diesem Abschnitt
Anleitung: Erstellen eines benutzerdefinierten Textvorlagen-Hosts zeigt Ihnen, wie Sie einen benutzerdefinierten Textvorlagen-Host erstellen, der die Textvorlagen-Funktionalität außerhalb von Visual Studio verfügbar macht.
Reference
Verwandte Inhalte
- Der Textvorlagentransformationsprozess beschreibt, wie die Texttransformation funktioniert und welche Teile Sie anpassen können.
- Das Erstellen von T4-basierten benutzerdefinierten Textvorlagen-Direktivenprozessoren bietet eine Übersicht über Textvorlagen-Direktivenprozessoren.