Generare file con l'utilità TextTransform

TextTransform.exe è uno strumento da riga di comando che è possibile usare per trasformare un modello di testo. Quando si chiama TextTransform.exe, specificare il nome di un file di modello di testo come argomento. TextTransform.exe chiama il motore di trasformazione del testo ed elabora il modello di testo. TextTransform.exe viene in genere chiamato dagli script. Tuttavia, in genere non è obbligatorio, perché è possibile eseguire la trasformazione del testo in Visual Studio o nel processo di compilazione.

Nota

Se si vuole eseguire la trasformazione del testo come parte di un processo di compilazione, è consigliabile usare l'attività di trasformazione testo MSBuild. Per altre informazioni, vedere Generazione di codice in un processo di compilazione. In un computer in cui è installato Visual Studio, è anche possibile scrivere un'applicazione o un'estensione di Visual Studio in grado di trasformare i modelli di testo. Per altre informazioni, vedere Elaborazione di modelli di testo tramite un host personalizzato.

TextTransform.exe si trova nella directory seguente:

\Programmi\Microsoft Visual Studio\2022\Professional\Common7\IDE

per l'edizione Professional o

\Programmi\Microsoft Visual Studio\2022\Enterprise\Common7\IDE

per Enterprise Edition.

Sintassi

TextTransform [<options>] <templateName>

Parametri

Argomento	Descrizione
templateName	Identifica il nome del file modello che si desidera trasformare.

Opzione	Descrizione
-out<filename>	File in cui viene scritto l'output della trasformazione.
-r<assembly>	Assembly utilizzato per la compilazione e l'esecuzione del modello di testo.
-u<spazio dei nomi>	Spazio dei nomi utilizzato per la compilazione del modello.
-I<includedirectory>	Directory contenente i modelli di testo inclusi nel modello di testo specificato.
-P<referencepath>	Directory in cui cercare gli assembly specificati all'interno del modello di testo o per l'uso dell'opzione -r . Ad esempio, per includere assembly usati per l'API di Visual Studio, usare -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<processorName>!<className>!<assemblyName|codeBase>	Nome, nome completo del tipo e assembly di un processore di direttiva che può essere usato per elaborare direttive personalizzate all'interno del modello di testo.
-a [processorName]![ directiveName]!<parameterName>!<Parametervalue>	Specificare un valore di parametro per un processore di direttiva. Se si specifica solo il nome e il valore del parametro, il parametro sarà disponibile per tutti i processori di direttiva. Se si specifica un processore di direttiva, il parametro è disponibile solo per il processore specificato. Se si specifica un nome di direttiva, il parametro è disponibile solo quando viene elaborata la direttiva specificata. Per accedere ai valori dei parametri da un processore di direttiva o da un modello di testo, usare ITextTemplatingEngineHost.ResolveParameterValue. In un modello di testo includere hostspecific nella direttiva modello e richiamare il messaggio in this.Host. Ad esempio: <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]. Digitare sempre i contrassegni '!', anche se si omettono i nomi facoltativi del processore e delle direttive. Ad esempio: -a !!param!value
-h	Fornisce assistenza.

Contenuto correlato

• Generazione di codice in fase di progettazione tramite modelli di testo T4
• Personalizzazione della trasformazione del testo T4
• Elaborazione di modelli di testo tramite un host personalizzato