Direttive di modello di testo T4

Le direttive forniscono istruzioni al motore di trasformazione del modello di testo.

La sintassi per le direttive è la seguente:

<#@ DirectiveName [AttributeName = "AttributeValue"] ... #>

Tutti i valori di attributo devono essere racchiusi tra virgolette doppie. Se il valore stesso contiene virgolette, è necessario applicare loro il carattere di escape \.

Le direttive sono in genere i primi elementi di un file modello o di un file incluso. Tali elementi non devono essere inseriti in un blocco di codice <#...#>, né dopo un blocco della funzionalità di classe <#+...#>.

• Direttiva template T4

  <#@ template [language="VB"] [hostspecific="true"] [debug="true"] [inherits="templateBaseClass"] [culture="code"] [compilerOptions="options"] #>
  

• Direttiva parameter T4

  <#@ parameter type="Full.TypeName" name="ParameterName" #>
  

• Direttiva output T4

  <#@ output extension=".fileNameExtension" [encoding="encoding"] #>
  

• Direttiva assembly T4

  <#@ assembly name="[assembly strong name|assembly file name]" #>
  

• Direttiva import T4

  <#@ import namespace="namespace" #>
  

• Direttiva include T4

  <#@ include file="filePath" #>
  

È inoltre possibile creare direttive personalizzate. Per ulteriori informazioni, vedere Creazione di processori di direttiva di modelli di testo personalizzati. Se si utilizza l'SDK di visualizzazione e modellazione per creare un linguaggio specifico di dominio (DSL), verrà generato un processore di direttiva come parte di tale linguaggio DSL.

Cronologia delle modifiche

Data	Cronologia	Motivo
Marzo 2011	Contenuto diviso in argomenti figlio.	Miglioramento delle informazioni.
Giugno 2010	Utilizzare $ (SolutionDir) nella direttiva dell'assembly. Nei modelli pre-elaborati, utilizzare invece i riferimenti al progetto. Aggiunto <#@Parameter#>. Aggiunte note su eredita e compilazione di un assembly a cui si fa riferimento in un modello.	Commenti e suggerimenti dei clienti.