Partilhar via

T4 Diretiva de Assembly

  • Artigo

Em um Visual Studio modelo de texto em tempo de design, o assembly diretiva carrega um assembly para que seu código de modelo possa usar seus tipos.O efeito é semelhante a adicionar uma referência de assembly em um Visual Studio project.

Para obter uma visão geral da escrita de modelos de texto, consulte Escrever um modelo de texto T4.

ObservaçãoObservação

Não é necessário o assembly diretiva em um modelo de texto (pré-processado) de tempo de execução.Em vez disso, adicione os assemblies necessários para o referências de seu Visual Studio project.

Usando a diretiva de Assembly

A sintaxe da diretiva é da seguinte maneira:

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

O nome do assembly deve ser um destes procedimentos:

  • O nome forte de um assembly no GAC, como System.Xml.dll.Você também pode usar a forma longa, como name="System.Xml, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089".Para obter mais informações, consulte AssemblyName.

  • O caminho absoluto do assembly

Você pode usar o $(variableName) sintaxe para fazer referência a Visual Studio ou variáveis MSBuild como $(SolutionDir), e %VariableName% a variáveis de ambiente de referência.Por exemplo:

<#@ assembly name="$(SolutionDir)\MyProject\bin\Debug\SomeLibrary.Dll" #>

A diretiva do assembly não tem efeito em um modelo de texto pré-processado.Em vez disso, inclua as referências necessárias a referências seção do seu Visual Studio projeto.Para obter mais informações, consulte Geração de texto de tempo de execução com modelos de texto T4.

Assemblies padrão

Os seguintes assemblies são carregados automaticamente, para que você não precisará escrever diretivas de assembly para eles:

  • Microsoft.VisualStudio.TextTemplating.1*.dll

  • System.dll

  • WindowsBase.dll

Se você usar uma diretiva personalizada, o processador de diretriz pode carregar assemblies adicionais.Por exemplo, se você escrever modelos para um idioma específico do domínio (DSL), você precisa escrever diretivas de assembly para os seguintes módulos:

  • Microsoft.VisualStudio.Modeling.Sdk.1*.dll

  • Microsoft.VisualStudio.Modeling.Sdk.Diagrams.1*.dsl

  • Microsoft.VisualStudio.TextTemplating.Modeling.1*.dll

  • O assembly que contém seu DSL.

Consulte também

Conceitos

T4 Diretiva de inclusão