Directiva de ensamblado T4
En Visual Studio la plantilla de texto en tiempo de diseño, la directiva assembly carga un ensamblado para que el código de plantilla pueda utilizar sus tipos.El efecto es similar a agregar una referencia al ensamblado en un proyecto de Visual Studio.
Para obtener información general sobre cómo escribir plantillas de texto, vea Escribir una plantilla de texto T4.
[!NOTA]
No necesita la directiva de salida assembly en una plantilla de texto (preprocesada) en tiempo de ejecución.En su lugar, agregue los ensamblados necesarios a las Referencias del proyecto de Visual Studio.
Usar la directiva de ensamblado
La sintaxis de las directivas es la siguiente:
<#@ assembly name="[assembly strong name|assembly file name]" #>
El nombre del ensamblado debe ser uno de los siguientes:
El nombre seguro de un ensamblado en la GAC, como System.Xml.dll.También puede utilizar el formulario largo, como name="System.Xml, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089".Para obtener más información, vea AssemblyName.
La ruta de acceso absoluta del ensamblado
También puede utilizar la sintaxis $(variableName) para hacer referencia a Visual Studio o a las variables de MSBuild, tales como $(SolutionDir), y %VariableName% para hacer referencia a las variables de entorno.Por ejemplo:
<#@ assembly name="$(SolutionDir)\MyProject\bin\Debug\SomeLibrary.Dll" #>
La directiva de ensamblado no tiene ningún efecto en una plantilla de texto preprocesada.En su lugar, incluya las referencias necesarias en la sección Referencias del proyecto de Visual Studio.Para obtener más información, vea Generación de texto en tiempo de ejecución con plantillas de texto T4.
Ensamblados estándar
Loa siguientes ensamblados se cargan automáticamente, por lo que no es necesario escribir las directivas de ensamblado para ellos:
Microsoft.VisualStudio.TextTemplating.1*.dll
System.dll
WindowsBase.dll
Si utiliza una directiva personalizada, el procesador de directivas podría cargar ensamblados adicionales.Por ejemplo, si escribe plantillas para un lenguaje específico del dominio (ADSL), no necesita escribir directivas de ensamblado para los siguientes ensamblados:
Microsoft.VisualStudio.Modeling.Sdk.1*.dll
Microsoft.VisualStudio.Modeling.Sdk.Diagrams.1*.dsl
Microsoft.VisualStudio.TextTemplating.Modeling.1*.dll
El ensamblado contiene el ADSL.