Compartilhar via

T4 Diretiva de Assembly

  • Artigo

Em um Visual Studio o modelo de texto em tempo de design, o assembly diretiva carrega um assembly para que possa usar o seu código de modelo 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 a diretiva em um tempo de execução (pré-processado) modelo de texto. 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 é o seguinte:

<#@ 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 de MSBuild como $(SolutionDir), e %VariableName% para variáveis de ambiente de referência. Por exemplo:

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

A diretiva de 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 project. Para obter mais informações, consulte Geração de texto de tempo de execução usando os 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 escrever modelos para um domínio específico de idioma (DSL), você não precisará escrever diretivas de assembly para os assemblies a seguintes:

  • 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

Outros recursos

T4 Diretiva de inclusão

Histórico de alterações

Date

History

Motivo

Março de 2011

Dividir o tópico do pai.

Aprimoramento de informações.