Personalizzazione della 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.Tramite l'utilizzo di Visual Studio SDK, è possibile estendere il processo di trasformazione del modello predefinito personalizzando il processore di direttiva del modello di testo o l'host del modello di testo.

In questa sezione

• Processo di trasformazione del modello di testo
  Viene descritto il funzionamento della trasformazione di testo e viene spiegato il ruolo dell'host del modello e dei processori di direttiva.

• Creazione di processori di direttiva di modelli di testo T4 personalizzati
  Il processore di direttiva consente di gestire le direttive nel modello, ad esempio <#@template#>.. Viene eseguito durante la compilazione del modello e consente di caricare assembly e altre risorse.Può inoltre inserire del codice che consentirà il caricamento di risorse in fase di runtime.La definizione del processore di direttiva permette di ridurre la complessità dei modelli.

• Richiamo della trasformazione del testo in un'estensione VS
  Se si scrive un'estensione di Visual Studio, quale un comando di menu o un gestore eventi, l'estensione può utilizzare Text Templating Service per trasformare qualsiasi modello di testo.È possibile passare i dati dei parametri nel modello tramite l'oggetto Session e ottenere i valori dal modello tramite la direttiva <#@parameter#>.

• Elaborazione di modelli di testo tramite un host personalizzato
  Quando il codice del modello di testo viene eseguito, l'host fornisce l'accesso a file esterni e allo stato dell'applicazione.Ad esempio, l'host nel quale vengono fornite le trasformazioni di testo in Visual Studio può fornire l'accesso a Esplora soluzioni.Inoltre, visualizza gli errori nella finestra di messaggio di errore.Se si desidera eseguire delle trasformazioni di testo in un contesto diverso, è possibile definire un proprio host che fornisca l'accesso ai servizi disponibili in quel contesto.

  Se si scrive un'estensione di Visual Studio, anziché scrivere un proprio host, considerare l'utilizzo del servizio di trasformazione del testo.Per ulteriori informazioni, vedere Richiamo della trasformazione del testo in un'estensione VS.

Riferimenti

Scrittura di un modello di testo T4

Fornisce la sintassi di direttive e blocchi di controllo del modello di testo.