Condividi tramite


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. Ad 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 tramite modelli di testo T4 pre-elaborati.

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.

Vedere anche

Altre risorse

Direttiva include T4

Cronologia delle modifiche

Data

Cronologia

Motivo

Marzo 2011

Diviso dall'argomento padre.

Miglioramento delle informazioni.