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. Usando Visual Studio SDK, è possibile estendere il processo di trasformazione modello predefinito personalizzando l'elaboratore di direttive del modello di testo o l'host modello di testo.

In questa sezione

Il processo di trasformazione Modello di testo Descrive il funzionamento della trasformazione del testo e spiega il ruolo dell'host modello e dei processori di direttiva.

Creazione di processori personalizzati di direttive modello di testo T4 Il processore di direttive gestisce 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.

Richiamo della trasformazione 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 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.

Contenuto correlato

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