Personalizzare la trasformazione del testo T4

I modelli di testo sono una funzionalità di Visual Studio che consente di generare codice programma o altri file di testo tramite un processo di trasformazione. Utilizzando il Visual Studio SDK, è possibile estendere il processo di trasformazione del modello predefinito personalizzando l'elaboratore di direttive del modello di testo o l'host del modello di testo.

In questa sezione

Il processo di trasformazione dei modelli di testo: descrive il funzionamento della trasformazione del testo e spiega il ruolo dell'host del modello e dei processori delle direttive.

Creazione di processori personalizzati di direttive per i modelli di testo T4: il processore di direttiva gestisce le direttive nel modello, ad esempio <#@template#>. Viene eseguito durante la compilazione del modello e può caricare assembly e altre risorse. Può anche inserire codice che caricherà le risorse in fase di esecuzione. Definendo un processore di direttiva personalizzato, è possibile ridurre la complessità dei modelli.

Richiamare la trasformazione del testo in un'estensione di Visual Studio: se si sta scrivendo un'estensione di Visual Studio, ad esempio un comando di menu o un gestore eventi, l'estensione può usare il servizio di modelli di testo per trasformare qualsiasi modello di testo. È possibile passare i dati dei parametri nel modello usando l'oggetto Session e ottenere i valori dall'interno del modello usando la <#@parameter#> direttiva .

Elaborazione di modelli di testo tramite un host personalizzato: quando viene eseguito il codice del modello di testo, l'host fornisce l'accesso ai file esterni e allo stato dell'applicazione. Ad esempio, l'host che esegue trasformazioni di testo in Visual Studio può fornire l'accesso a Esplora soluzioni. Vengono inoltre visualizzati errori nella finestra dei messaggi di errore. Se si desidera eseguire trasformazioni di testo in un contesto diverso, è possibile definire un host personalizzato che fornisca l'accesso ai servizi disponibili in tale contesto.

Se si sta scrivendo un'estensione di Visual Studio, è consigliabile usare il servizio di trasformazione del testo esistente anziché scrivere il proprio host. Per altre informazioni, vedere Richiamo della trasformazione del testo in un'estensione di Visual Studio.

Contenuti correlati

• Scrivere un modello di testo T4 fornisce la sintassi delle direttive del modello di testo e dei blocchi di controllo.