Share via


Bestanden genereren met het hulpprogramma TextTransform

TextTransform.exe is een opdrachtregelprogramma dat u kunt gebruiken om een tekstsjabloon te transformeren. Wanneer u TextTransform.exeaanroept, geeft u de naam van een tekstbestand op als argument. TextTransform.exe de engine voor teksttransformatie aanroept en de tekstsjabloon verwerkt. TextTransform.exe wordt meestal aangeroepen vanuit scripts. Dit is echter niet vereist, omdat u teksttransformatie in Visual Studio of in het buildproces kunt uitvoeren.

Opmerking

Als u teksttransformatie wilt uitvoeren als onderdeel van een buildproces, kunt u overwegen om de msBuild-teksttransformatietaak te gebruiken. Zie Code genereren in een buildproces voor meer informatie. Op een computer waarop Visual Studio is geïnstalleerd, kunt u ook een toepassing of Visual Studio-extensie schrijven waarmee tekstsjablonen kunnen worden getransformeerd. Zie Tekstsjablonen verwerken met behulp van een aangepaste host voor meer informatie.

TextTransform.exe bevindt zich in de volgende map:

Syntaxis

TextTransform [<options>] <templateName>

Parameterwaarden

argument Beschrijving
templateName Identificeert de naam van het sjabloonbestand dat u wilt transformeren.
Optie Beschrijving
-out<Bestandsnaam> Het bestand waarnaar de uitvoer van de transformatie wordt geschreven.
-r<assemblage> Een assembly die wordt gebruikt voor het compileren en uitvoeren van de tekstsjabloon.
-u<namespace> Een naamruimte die wordt gebruikt voor het compileren van de sjabloon.
-ik<includedirectory> Een map met de tekstsjablonen die zijn opgenomen in de opgegeven tekstsjabloon.
-P<referencepath> Een map voor het zoeken naar assembly's die zijn opgegeven in de tekstsjabloon of voor het gebruik van de optie -r .

Om bijvoorbeeld assembly's te includeren die worden gebruikt voor de Visual Studio-API, kunt u gebruiken

-P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<processorName>!<className>!<assemblyName|codeBase> De naam, de volledige typenaam en de assembly van een richtlijnprocessor die kan worden gebruikt voor het verwerken van aangepaste instructies in de tekstsjabloon.
-a [processorName]![directiveName]!<parameterName>!<parameterValue> Geef een parameterwaarde op voor een instructieprocessor. Als u alleen de parameternaam en -waarde opgeeft, is de parameter beschikbaar voor alle instructieprocessors. Als u een richtlijnprocessor opgeeft, is de parameter alleen beschikbaar voor de opgegeven processor. Als u een instructienaam opgeeft, is de parameter alleen beschikbaar wanneer de opgegeven instructie wordt verwerkt.

Gebruik ITextTemplatingEngineHost.ResolveParameterValue om toegang te krijgen tot de parameterwaarden van een instructieprocessor of tekstsjabloon. Neem in een tekstsjabloon de sjabloonrichtlijn met hostspecific op en roep het bericht op bij this.Host. Voorbeeld:

<#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>].

Typ altijd de '!'-markeringen, zelfs als u de optionele processor- en instructienamen weglaat. Voorbeeld:

-a !!param!value
-h Biedt hulp.