Anpassa T4-texttransformeringen

Textmallar är en funktion i Visual Studio som gör att du kan generera programkod eller andra textfiler genom en transformeringsprocess. Genom att använda Visual Studio SDK kan du utöka standardprocessen för omvandling av mallar genom att anpassa textmalldirektivprocessorn eller textmallvärden.

I det här avsnittet

Textmallstransformationsprocessen: Beskriver hur texttransformeringen fungerar och förklarar mallvärdarnas och direktivprocessorernas roller.

Skapa anpassade T4-textmallsdirektivprocessorer: Direktivprocessorn hanterar direktiv i mallen, till exempel <#@template#>. Den körs under kompilering av mallen och kan läsa in sammansättningar och andra resurser. Den kan också infoga kod som läser in resurser vid körtid. Genom att definiera en egen direktivprocessor kan du minska komplexiteten i dina mallar.

Anropa texttransformering i ett VS-tillägg: Om du skriver ett Visual Studio-tillägg, till exempel ett menykommando eller händelsehanterare, kan tillägget använda texttempleringstjänsten för att transformera valfri textmall. Du kan skicka parameterdata till mallen med hjälp av sessionsobjektet och hämta värdena inifrån mallen med hjälp <#@parameter#> av direktivet.

Bearbeta textmallar med hjälp av en anpassad värd: När koden för textmallen körs ger värden åtkomst till externa filer och programmets tillstånd. Till exempel kan värden som kör texttransformeringar i Visual Studio ge åtkomst till Solution Explorer. Den visar även fel i felmeddelandefönstret. Om du vill köra texttransformeringar i en annan kontext kan du definiera din egen värd som ger åtkomst till de tjänster som är tillgängliga i den kontexten.

Om du skriver ett Visual Studio-tillägg bör du överväga att använda den befintliga texttransformeringstjänsten i stället för att skriva en egen värd. Mer information finns i Anropa texttransformering i ett VS-tillägg.

Relaterat innehåll

• Skriv en T4-textmall innehåller syntaxen för textmallsdirektiv och kontrollblock.