Directiva de ensamblado T4

  • Artículo

En una plantilla de texto en tiempo de diseño de Visual Studio, 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, consulte 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 usar la sintaxis $(variableName) para hacer referencia a variables de Visual Studio, como $(SolutionDir), y usar %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.

Usar las propiedades del proyecto en MSBuild y Visual Studio

Las macros de Visual Studio, como $ (SolutionDir), no funcionan en MSBuild. Si desea transformar plantillas del equipo de compilación, tiene que utilizar las propiedades del proyecto.

Modifique el archivo .csproj o .vbproj para definir una propiedad de proyecto. En este ejemplo se define una propiedad denominada myLibFolder:

<!-- Define a project property, myLibFolder: -->
<PropertyGroup>
    <myLibFolder>$(MSBuildProjectDirectory)\..\libs</myLibFolder>
</PropertyGroup>

<!-- Tell the MSBuild T4 task to make the property available: -->
<ItemGroup>
    <T4ParameterValues Include="myLibFolder">
      <Value>$(myLibFolder)</Value>
    </T4ParameterValues>
  </ItemGroup>

Ahora puede utilizar la propiedad del proyecto en plantillas de texto, que se transformarán correctamente en Visual Studio y MSBuild:

<#@ assembly name="$(myLibFolder)\MyLib.dll" #>

Consulte también