Generazione di file con l'utilità TextTransform

TextTransform.exe è uno strumento da riga di comando utilizzabile per trasformare un modello di testo. Quando si chiama TextTransform.exe, si specifica il nome di un file modello di testo come argomento. TextTransform.exe chiama il motore di trasformazione di testo ed elabora il modello di testo. TextTransform.exe viene chiamato di solito dagli script.

Nota

Se si desidera eseguire trasformazione di testo come parte di un processo di compilazione, utilizzare l'attività di trasformazione testo MSBuild. Per ulteriori informazioni, vedere Generazione di codice in un processo di compilazione. In un computer nel quale viene installato Visual Studio, è inoltre possibile scrivere un'applicazione o un Estensione Visual Studio che può trasformare i modelli di testo. Per ulteriori informazioni, vedere Elaborazione di modelli di testo tramite un host personalizzato.

TextTransform.exe viene inserito nella seguente directory:

\Program Files\Common Files\Microsoft Shared\TextTemplating\10.0

TextTransform [<options>] <templateName>

Parametri

Argomento	Oggetto di descrizione
templateName	Identifica il nome del file modello che si desidera trasformare.

Opzione	Oggetto di descrizione
-out <filename>	Il file in cui l'output della trasformazione è scritto.
-r <assembly>	Un assembly utilizzato per la compilazione e l'esecuzione del modello di testo.
-u <spazio dei nomi>	Uno spazio dei nomi utilizzato per la compilazione del modello.
-I <includedirectory>	Una directory che contiene i modelli di testo inclusa nel modello di testo specificato.
-P <referencespath>	Una directory per cercare gli assembly specificati all'interno del modello di testo o per l'utilizzo dell'opzione -r. Ad esempio per includere gli assembly utilizzati per Visual Studio API, utilizzare -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp < processorName >! < nomeclasse >! < assemblyName | il codebase >	Il nome, il nome di tipo completo e assembly di un processore di direttiva che può essere utilizzato per elaborare direttive personalizzate all'interno del modello di testo.
-a [processorName]! [directiveName]! < parameterName >! < parameterValue > Attenzione Digitare sempre i contrassegni '!', persino se si omettono i nomi facoltativi di processore e direttiva.Di seguito è riportato un esempio. -a !!param!value	Specificare un valore del parametro per un processore di direttiva. Se si specifica solo il valore e il nome 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 del parametro da un processore di direttiva o da un modello di testo, utilizzare ResolveParameterValue(String, String, String). In un modello di testo includere hostspecific nella direttiva template e richiamare il messaggio su this.Host. Di seguito è riportato un esempio. <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]
-h	Fornisce la Guida.

Argomenti correlati

Task	Argomento
Generare file in una soluzione Visual Studio.	Generazione di codice in fase di progettazione tramite modelli di testo T4
Scrivere processori di direttive per trasformare le proprie origini dati.	Personalizzazione della trasformazione del testo T4
Scrivere un host di modello testo che consente di richiamare modelli di testo dall'applicazione.	Elaborazione di modelli di testo tramite un host personalizzato

Cronologia delle modifiche

Data	Cronologia	Motivo
Giugno 2010	Aggiunte informazioni sull'opzione –a.	Commenti e suggerimenti dei clienti.