Condividi tramite


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 >

Nota di avvisoAttenzione
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.