Direttiva assembly T4
In un modello di testo della fase di progettazione di Visual Studio, la direttiva assembly carica un assembly in modo che il codice del modello possa utilizzarne i tipi.L'effetto è simile all'aggiunta di un riferimento all'assembly in un progetto di Visual Studio.
Per cenni preliminari sulla scrittura dei modelli di testo, vedere Scrittura di un modello di testo T4.
[!NOTA]
La direttiva assembly in un modello di testo (pre-elaborato) della fase di esecuzione non è necessaria.Aggiungere invece gli assembly necessari ai Riferimenti del progetto di Visual Studio.
Utilizzo della direttiva Assembly
La sintassi della direttiva è la seguente:
<#@ assembly name="[assembly strong name|assembly file name]" #>
Il nome dell'assembly deve essere uno dei seguenti:
Il nome sicuro dell'assembly nella GAC, quale System.Xml.dll.È inoltre possibile utilizzare la forma estesa, quale name="System.Xml, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089".Per ulteriori informazioni, vedere AssemblyName.
Il percorso assoluto dell'assembly
È possibile utilizzare anche la sintassi $(variableName) per fare riferimento alle variabili Visual Studio o MSBuild, quale $(SolutionDir) e %VariableName% per fare riferimento alle variabili di ambiente.Di seguito è riportato un esempio:
<#@ assembly name="$(SolutionDir)\MyProject\bin\Debug\SomeLibrary.Dll" #>
La direttiva dell'assembly non ha alcun effetto in un modello di testo pre-elaborato.Al contrario, si consiglia di includere i riferimenti necessari nella sezione Riferimenti del progetto Visual Studio.Per ulteriori informazioni, vedere Generazione di testo in fase di esecuzione con modelli di testo T4.
Assembly standard
Gli assembly seguenti vengono caricati automaticamente, in modo che non sia necessario scrivere per essi direttive dell'assembly:
Microsoft.VisualStudio.TextTemplating.1*.dll
System.dll
WindowsBase.dll
Se si utilizza una direttiva personalizzata, il processore di direttiva potrebbe caricare assembly aggiuntivi.Ad esempio, se si scrivono modelli per un linguaggio specifico di dominio (DSL), non è necessario scrivere direttive dell'assembly per gli assembly seguenti:
Microsoft.VisualStudio.Modeling.Sdk.1*.dll
Microsoft.VisualStudio.Modeling.Sdk.Diagrams.1*.dsl
Microsoft.VisualStudio.TextTemplating.Modeling.1*.dll
Assembly contenente il modello DSL.