Compartilhar via


Tarefa do AL (do Assembly Linker)

A tarefa AL quebra AL.exe, uma ferramenta que é distribuída com o Windows Software Development Kit (SDK). Esta ferramenta Assembly Linker é usada para criar um assembly com um manifesto de um ou mais arquivos que estão em módulos ou arquivos de recurso. Compiladores e ambientes de desenvolvimento podem já oferecer estas capacidades, portanto, geralmente não é necessário usar essa tarefa diretamente. O Assembly Linker é mais útil para desenvolvedores que precisam criar um único assembly a partir de vários arquivos de componentes, como aqueles que poderiam ser produzidos por um desenvolvimento multi-idiomas. Esta tarefa não combinar os módulos em um arquivo de assembly único; os módulos individuais ainda devem ser distribuído e disponível para o assembly resultante carregar corretamente. Para obter mais informações sobre AL.exe, consulte AL.exe (do Assembly Linker).

Parâmetros

A tabela a seguir descreve os parâmetros da AL de tarefas.

Parâmetro

Descrição

AlgorithmID

Opcional String parâmetro.

Especifica um algoritmo para hash todos os arquivos em um conjunto de vários arquivos, exceto o arquivo que contém o manifesto conjunto. Para obter mais informações, consulte a documentação para o /algid opção na AL.exe (do Assembly Linker).

BaseAddress

Opcional String parâmetro.

Especifica o endereço no qual uma DLL será carregada no computador do usuário em tempo de execução. Aplicativos carregada mais rapidamente se você especificar o endereço básico de rather than as DLLs, permitindo que o Operating System realocar as DLLs no espaço de processo. Este parâmetro corresponde à opção /base [endereço] AL.exe (do Assembly Linker).

CompanyName

Opcional String parâmetro.

Especifica uma seqüência de caracteres para o Company campo no assembly. Para obter mais informações, consulte a documentação para o /comp[any] opção na AL.exe (do Assembly Linker).

Configuration

Opcional String parâmetro.

Especifica uma seqüência de caracteres para o Configuration campo no assembly. Para obter mais informações, consulte a documentação para o /config[uration] opção na AL.exe (do Assembly Linker).

Copyright

Opcional String parâmetro.

Especifica uma seqüência de caracteres para o Copyright campo no assembly. Para obter mais informações, consulte a documentação para o /copy[right] opção na AL.exe (do Assembly Linker).

Culture

Opcional String parâmetro.

Especifica a sequência cultura para associar ao conjunto. Para obter mais informações, consulte a documentação para o /c[ulture] opção na AL.exe (do Assembly Linker).

DelaySign

Opcional Boolean parâmetro.

truepara colocar somente a chave pública do assembly; falsepara assinar uma assembly totalmente. Para obter mais informações, consulte a documentação para o /delay[sign] opção na AL.exe (do Assembly Linker).

Description

Opcional String parâmetro.

Especifica uma seqüência de caracteres para o Description campo no assembly. Para obter mais informações, consulte a documentação para o /descr[iption] opção na AL.exe (do Assembly Linker).

EmbedResources

Opcional ITaskItem[] parâmetro.

Incorpora os recursos especificados na imagem que contém o manifesto do assembly. Esta tarefa copia o conteúdo do arquivo de recurso na imagem. Os itens passados para este parâmetro podem ter metadados opcionais anexados a eles chamado LogicalName e Access. O LogicalName metadados é usado para especificar o identificador interno para o recurso. O Access metadados podem ser definido como private para tornar o recurso não é visível para outros assemblies. Para obter mais informações, consulte a documentação para o /embed[resource] opção na AL.exe (do Assembly Linker).

EvidenceFile

Opcional String parâmetro.

Incorpora o arquivo especificado no assembly com o nome do recurso de Security.Evidence.

Não é possível usar Security.Evidence para recursos regulares. Este parâmetro corresponde do /e[vidence] opção na AL.exe (do Assembly Linker).

ExitCode

Opcional Int32 saída somente leitura parâmetro.

Especifica o código de saída fornecido pelo comando executado.

FileVersion

Opcional String parâmetro.

Especifica uma seqüência de caracteres para o File Version campo no assembly. Para obter mais informações, consulte a documentação para o /fileversion opção na AL.exe (do Assembly Linker).

Flags

Opcional String parâmetro.

Especifica um valor para o Flags campo no assembly. Para obter mais informações, consulte a documentação para o /flags opção na AL.exe (do Assembly Linker).

GenerateFullPaths

Opcional Boolean parâmetro.

Faz com que a tarefa para usar o caminho absoluto para arquivos que são relatados em uma mensagem de erro. Este parâmetro corresponde do /fullpaths opção na AL.exe (do Assembly Linker).

KeyContainer

Opcional String parâmetro.

Especifica um contêiner que contém um par de chaves. Isso irá assinar o assembly (dar um nome forte) inserindo-se em uma chave pública no manifesto do assembly. A tarefa será, em seguida, assinar uma assembly final com a chave particular. Para obter mais informações, consulte a documentação para o /keyn[ame] opção na AL.exe (do Assembly Linker).

KeyFile

Opcional String parâmetro.

Especifica um arquivo que contém um par de chaves ou apenas uma chave pública para assinar um assembly. O compilador insere a chave pública no manifesto montagem e depois assina montagem final com a chave particular. Para obter mais informações, consulte a documentação para o /keyf[ile] opção na AL.exe (do Assembly Linker).

LinkResources

Opcional ITaskItem[] parâmetro.

Vincula os arquivos de recurso especificado a um assembly. O recurso se torna parte do assembly, mas o arquivo não é copiado. Os itens passados para este parâmetro podem ter metadados opcionais anexados a eles chamado LogicalName, Target, e Access. O LogicalName metadados é usado para especificar o identificador interno para o recurso. O Target metadados podem especificar o caminho e nome de arquivo ao qual a tarefa copia o arquivo, após o qual ele compila esse novo arquivo para o assembly. O Access metadados podem ser definido como private para tornar o recurso não é visível para outros assemblies. Para obter mais informações, consulte a documentação para o /link[resource] opção na AL.exe (do Assembly Linker).

MainEntryPoint

Opcional String parâmetro.

Especifica o nome totalmente qualificado (class.method) do método para usar como ponto de entrada ao converter um módulo para um arquivo executável. Este parâmetro corresponde do /main opção na AL.exe (do Assembly Linker).

OutputAssembly

Obrigatório ITaskItem parâmetro de saída.

Especifica o nome do arquivo gerado por essa tarefa. Este parâmetro corresponde do /out opção na AL.exe (do Assembly Linker).

Platform

Opcional String parâmetro.

Limita o que plataforma este código pode ser executado; must be one of x86, Itanium, x64, or anycpu. O padrão é anycpu. Este parâmetro corresponde do /platform opção na AL.exe (do Assembly Linker).

ProductName

Opcional String parâmetro.

Especifica uma seqüência de caracteres para o Product campo no assembly. Para obter mais informações, consulte a documentação para o /prod[uct] opção na AL.exe (do Assembly Linker).

ProductVersion

Opcional String parâmetro.

Especifica uma seqüência de caracteres para o ProductVersion campo no assembly. Para obter mais informações, consulte a documentação para o /productv[ersion] opção na AL.exe (do Assembly Linker).

ResponseFiles

Opcional String[] parâmetro.

Especifica os arquivos de resposta que contenham opções adicionais para passar para o vinculador do Assembly.

SdkToolsPath

Opcional String parâmetro.

Especifica o caminho para as ferramentas do SDK, como, por exemplo, Resgen. exe.

SourceModules

Opcional ITaskItem[] parâmetro.

Um ou mais módulos para ser compilado em um assembly. Os módulos serão listados no manifesto do assembly resultante e ainda precisará distribuído e disponível para carregar o assembly. Os itens passados para este parâmetro podem ter metadados adicionais chamado Target, que especifica o caminho e nome de arquivo ao qual a tarefa copia o arquivo, após o qual ele compila esse novo arquivo para o assembly. Para obter mais informações, consulte a documentação de AL.exe (do Assembly Linker). Este parâmetro corresponde à lista de módulos passados em Al.exe sem um switch específico.

TargetType

Opcional String parâmetro.

Especifica o formato de arquivo do arquivo de saída: library(biblioteca de código), exe (aplicativo de console), ou win (aplicativo baseado no Windows). O padrão é library. Este parâmetro corresponde do /t[arget] opção na AL.exe (do Assembly Linker).

TemplateFile

Opcional String parâmetro.

Especifica o conjunto do qual herdar todos os metadados do assembly, exceto o campo da cultura. O assembly especificado deve ter um nome forte.

Um assembly que você cria com o TemplateFile parâmetro será um assembly satélite. Este parâmetro corresponde do /template opção na AL.exe (do Assembly Linker).

Timeout

Opcional Int32 parâmetro.

Especifica a quantidade de tempo, em milissegundos, após o qual a tarefa executável é encerrada. O valor padrão é Int.MaxValue, indicando que não há nenhum período de tempo limite.

Title

Opcional String parâmetro.

Especifica uma seqüência de caracteres para o Title campo no assembly. Para obter mais informações, consulte a documentação para o /title opção na AL.exe (do Assembly Linker).

ToolPath

Opcional String parâmetro.

Especifica o local de onde a tarefa será carregado o arquivo executável subjacente (Al.exe). Se este parâmetro não for especificado, a tarefa usa o caminho de instalação do SDK correspondentes à versão do framework que está executando o MSBuild.

Trademark

Opcional String parâmetro.

Especifica uma seqüência de caracteres para o Trademark campo no assembly. Para obter mais informações, consulte a documentação para o /trade[mark] opção na AL.exe (do Assembly Linker).

Version

Opcional String parâmetro.

Especifica as informações de versão para este assembly. O formato da seqüência de caracteres é major.minor.build.revision. O valor padrão é 0. Para obter mais informações, consulte a documentação para o /v[ersion] opção na AL.exe (do Assembly Linker).

Win32Icon

Opcional String parâmetro.

Insere um arquivo.ico na montagem. O arquivo.ico oferece o arquivo de saída a aparência desejada no Windows Explorer. Este parâmetro corresponde do /win32icon opção na AL.exe (do Assembly Linker).

Win32Resource

Opcional String parâmetro.

Insere um recurso do Win32 (arquivo. res) no arquivo de saída. Para obter mais informações, consulte a documentação para o /win32res opção na AL.exe (do Assembly Linker).

Comentários

Além de para os parâmetros listados acima, esta tarefa herda os parâmetros da ToolTaskExtension , a própria classe herda o ToolTask classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base de ToolTaskExtension.

Exemplo

O exemplo a seguir cria um assembly com as opções especificadas.

<AL
    EmbedResources="@(EmbeddedResource)"
    Culture="%(EmbeddedResource.Culture)"
    TemplateFile="@(IntermediateAssembly)"
    KeyContainer="$(KeyContainerName)"
    KeyFile="$(KeyOriginatorFile)"
    DelaySign="$(DelaySign)"

    OutputAssembly=
       "%(EmbeddedResource.Culture)\$(TargetName).resources.dll">

    <Output TaskParameter="OutputAssembly"
        ItemName="SatelliteAssemblies"/>
</AL>

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild