Bearbeta textmallar med hjälp av en anpassad värd

Omvandlingsprocessen för textmallen tar en textmallfil som indata och skapar en textfil som utdata. Du kan anropa texttransformeringsmotorn från ett Visual Studio-tillägg eller från ett fristående program som körs på en dator där Visual Studio är installerat. Du måste dock ange en texthanterande värd. Den här klassen ansluter mallen till miljön, söker efter resurser som sammansättningar och inkluderar filer samt hanterar utdata och felmeddelanden.

Tips/Råd

Om du skriver ett paket eller tillägg som ska köras i Visual Studio bör du överväga att använda textredigeringstjänsten i stället för att skriva en egen värd. Mer information finns i Anropa texttransformering i ett VS-tillägg.

Anmärkning

Vi rekommenderar inte att du använder omvandlingar av textmallar i serverprogram. Vi rekommenderar inte att du använder omvandlingar av textmallar förutom i en enda tråd. Det beror på att textberäkningsmotorn återanvänder en enda AppDomain för att översätta, kompilera och köra mallar. Den översatta koden är inte utformad för att vara trådsäker. Motorn är utformad för att bearbeta filer seriellt, eftersom de finns i ett Visual Studio-projekt vid designtillfället.

Överväg att använda förbearbetade textmallar för körtidsapplikationer: se Run-Time Textgenerering med T4-textmallar.

Om ditt program använder en uppsättning mallar som är fasta vid kompileringstiden är det enklare att använda förbearbetade textmallar. Du kan också använda den metoden om programmet körs på en dator där Visual Studio inte är installerat. För mer information, se i Run-Time textgenerering med T4-textmallar.

Köra en textmall i ditt program

Om du vill köra en textmall anropar du metoden ProcessTemplate för Microsoft.VisualStudio.TextTemplating.Engine:

using Microsoft.VisualStudio.TextTemplating;
...
Engine engine = new Engine();
string output = engine.ProcessTemplate(templateString, host);

Ditt program måste hitta och ange mallen och måste hantera utdata.

I parametern host måste du ange en klass som implementerar ITextTemplatingEngineHost. Detta återkallas av motorn.

Värden måste kunna logga fel, lösa referenser till sammansättning och inkludera filer, ange en programdomän där mallen kan köras och anropa lämplig processor för varje direktiv.

Microsoft.VisualStudio.TextTemplating.Engine definieras i Microsoft.VisualStudio.TextTemplating.*.0.dlloch ITextTemplatingEngineHost definieras i Microsoft.VisualStudio.TextTemplating.Interfaces.*.0.dll.

I det här avsnittet

Genomgång: När du skapar en värd för anpassad textmall visas hur du skapar en anpassad textmallsvärd som gör textmallens funktioner tillgängliga utanför Visual Studio.

Hänvisning

ITextTemplatingEngineHost

Relaterat innehåll

• Omvandlingsprocessen för textmallar beskriver hur texttransformeringen fungerar och vilka delar du kan anpassa.
• När du skapar anpassade T4-textmallsdirektivsprocessorer får du en översikt över bearbetningsprocessorer för textmallsdirektiv.