Tarefa AL (Assembly Linker)
A tarefa de AL envolve AL.exe, uma ferramenta que é destinado com Windows Software Development Kit (SDK). Essa ferramenta do assembly linker é usada para criar um assembly com um manifesto de um ou mais arquivos que são módulos ou arquivos de recurso. Compiladores e ambientes de desenvolvimento ainda podem fornecer esses recursos, de forma que geralmente não é necessário usar diretamente esta tarefa. O vinculador assembly é mais útil para os desenvolvedores que precisam criar um único conjunto de módulos (assembly) de vários arquivos componentes, como aqueles que podem ser geradas de desenvolvimento de misto linguagem. Esta tarefa não combina os módulos em um único arquivo do assembly; módulos individuais distribuídos e ainda devem estar disponíveis para o assembly resultante carregue corretamente. Para obter mais informações sobre AL.exe, consulte Al.exe (Assembly Linker).
Parâmetros
A tabela a seguir descreve os parâmetros de tarefa de AL .
Parâmetro |
Descrição |
|---|---|
AlgorithmID |
Parâmetro opcional de String . Especifica um algoritmo de hash todos os arquivos em um assembly multi-arquivos exceto o arquivo que contém o manifesto do assembly. Para mais informações, consulte a documentação para a opção de /algid em Al.exe (Assembly Linker). |
BaseAddress |
Parâmetro opcional de String . Especifica o endereço em uma DLL que será carregado no computador do usuário em tempo de execução. Os aplicativos usam mais rapidamente se você especificar o endereço básico de DLL, em vez de deixando o sistema operacional realoque as dlls no espaço do processo. Este parâmetro corresponde a opção /base [] endereço em Al.exe (Assembly Linker). |
CompanyName |
Parâmetro opcional de String . Especifica uma cadeia de caracteres para o campo de Company no assembly. Para mais informações, consulte a documentação para a opção de /comp[any] em Al.exe (Assembly Linker). |
Configuration |
Parâmetro opcional de String . Especifica uma cadeia de caracteres para o campo de Configuration no assembly. Para mais informações, consulte a documentação para a opção de /config[uration] em Al.exe (Assembly Linker). |
Copyright |
Parâmetro opcional de String . Especifica uma cadeia de caracteres para o campo de Copyright no assembly. Para mais informações, consulte a documentação para a opção de /copy[right] em Al.exe (Assembly Linker). |
Culture |
Parâmetro opcional de String . Especifica a cadeia de caracteres de cultura para associar o assembly. Para mais informações, consulte a documentação para a opção de /c[ulture] em Al.exe (Assembly Linker). |
DelaySign |
Parâmetro opcional de Boolean . true para colocar somente a chave pública do assembly; false para assinar totalmente o assembly. Para mais informações, consulte a documentação para a opção de /delay[sign] em Al.exe (Assembly Linker). |
Description |
Parâmetro opcional de String . Especifica uma cadeia de caracteres para o campo de Description no assembly. Para mais informações, consulte a documentação para a opção de /descr[iption] em Al.exe (Assembly Linker). |
EmbedResources |
Parâmetro opcional de ITaskItem[] . Inserir 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 esse parâmetro podem ter os metadados opcionais anexados a eles LogicalName chamado e Access. Os metadados de LogicalName são usados para especificar o identificador interno para o recurso. Os metadados de Access pode ser definido private para tornar o recurso não visível para outros assemblies. Para mais informações, consulte a documentação para a opção de /embed[resource] em Al.exe (Assembly Linker). |
EvidenceFile |
Parâmetro opcional de String . Insere o arquivo especificado no assembly com o nome de recurso de Security.Evidence. Você não pode usar Security.Evidence para recursos normais. Este parâmetro corresponde à opção de /e[vidence] em Al.exe (Assembly Linker). |
ExitCode |
Parâmetros opcionais somente leitura de saída de Int32 . Especifica o código de saída fornecido pelo comando executado. |
FileVersion |
Parâmetro opcional de String . Especifica uma cadeia de caracteres para o campo de File Version no assembly. Para mais informações, consulte a documentação para a opção de /fileversion em Al.exe (Assembly Linker). |
Flags |
Parâmetro opcional de String . Especifica um valor para o campo de Flags no assembly. Para mais informações, consulte a documentação para a opção de /flags em Al.exe (Assembly Linker). |
GenerateFullPaths |
Parâmetro opcional de Boolean . Faz com que a tarefa usar o caminho absoluto para todos os arquivos que são reportados em uma mensagem de erro. Este parâmetro corresponde à opção de /fullpaths em Al.exe (Assembly Linker). |
KeyContainer |
Parâmetro opcional de String . Especifica um contêiner que contém um par de chaves. Isso assinará o assembly (lhe dê um nome forte) inserindo uma chave pública no manifesto do assembly. A tarefa assinará no assembly final com a chave particular. Para mais informações, consulte a documentação para a opção de /keyn[ame] em Al.exe (Assembly Linker). |
KeyFile |
Parâmetro opcional de String . 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 do assembly e assina o assembly final com a chave particular. Para mais informações, consulte a documentação para a opção de /keyf[ile] em Al.exe (Assembly Linker). |
LinkResources |
Parâmetro opcional de ITaskItem[] . Vincula os arquivos de recursos especificados em um assembly. O recurso torna parte do assembly, mas o arquivo não é copiado. Os itens passados para esse parâmetro podem ter os metadados opcionais anexados a eles LogicalNamechamado, Target, e Access. Os metadados de LogicalName são usados para especificar o identificador interno para o recurso. Os metadados de Target podem especificar o caminho e o nome de arquivo para que a tarefa copia o arquivo, depois do que compila esse novo arquivo do assembly. Os metadados de Access pode ser definido private para tornar o recurso não visível para outros assemblies. Para mais informações, consulte a documentação para a opção de /link[resource] em Al.exe (Assembly Linker). |
MainEntryPoint |
Parâmetro opcional de String . Especifica o nome totalmente qualificado ()class.methoddo método para usar como um ponto de entrada para converter um módulo em um arquivo executável. Este parâmetro corresponde à opção de /main em Al.exe (Assembly Linker). |
OutputAssembly |
Parâmetro de saída de ITaskItem necessário. Especifica o nome do arquivo gerado por essa tarefa. Este parâmetro corresponde à opção de /out em Al.exe (Assembly Linker). |
Platform |
Parâmetro opcional de String . Limites em que a plataforma esse código pode ser executado; deve ser um de x86, de Itanium, de x64, ou de anycpu. O padrão é anycpu. Este parâmetro corresponde à opção de /platform em Al.exe (Assembly Linker). |
ProductName |
Parâmetro opcional de String . Especifica uma cadeia de caracteres para o campo de Product no assembly. Para mais informações, consulte a documentação para a opção de /prod[uct] em Al.exe (Assembly Linker). |
ProductVersion |
Parâmetro opcional de String . Especifica uma cadeia de caracteres para o campo de ProductVersion no assembly. Para mais informações, consulte a documentação para a opção de /productv[ersion] em Al.exe (Assembly Linker). |
ResponseFiles |
Parâmetro opcional de String[] . Especifica arquivos de resposta que contêm opções adicionais passar pelo vinculador assembly. |
SdkToolsPath |
Parâmetro opcional de String . Especifica o caminho ferramentas SDK, como resgen.exe. |
SourceModules |
Parâmetro opcional de ITaskItem[] . Um ou vários módulos a ser compilados em um assembly. Módulos constarão no manifesto do assembly resultante, e ainda precisarão distribuído e disponível para o assembly carregue. Os itens passados em este parâmetro podem ter os metadados adicionais chamados Target, especificando o caminho e o nome de arquivo para que a tarefa copia o arquivo, depois do que compila esse novo arquivo do assembly. Para mais informações, consulte a documentação para Al.exe (Assembly Linker). Este parâmetro corresponde à lista de módulos passados em Al.exe sem uma opção específico. |
TargetType |
Parâmetro opcional de String . Especifica o formato do arquivo de saída: library (biblioteca de códigos), exe (aplicativo de console), ou win (aplicativo baseado no Windows). O padrão é library. Este parâmetro corresponde à opção de /t[arget] em Al.exe (Assembly Linker). |
TemplateFile |
Parâmetro opcional de String . Especifica o assembly do qual herdar todos os metadados do assembly, a não ser que o campo de cultura. O conjunto especificado deve ter um nome forte. Um assembly que você crie com o parâmetro de TemplateFile será um assembly satélite. Este parâmetro corresponde à opção de /template em Al.exe (Assembly Linker). |
Timeout |
Parâmetro opcional de Int32 . Especifica a quantidade de tempo, em milissegundos, depois do que o executável de tarefa é encerrado. O valor padrão é Int.MaxValue, indicando que não há nenhum intervalo de tempo limite. |
Title |
Parâmetro opcional de String . Especifica uma cadeia de caracteres para o campo de Title no assembly. Para mais informações, consulte a documentação para a opção de /title em Al.exe (Assembly Linker). |
ToolPath |
Parâmetro opcional de String . Especifica o local de onde a tarefa carregará 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 que corresponde à versão do framework que está executando MSBuild. |
Trademark |
Parâmetro opcional de String . Especifica uma cadeia de caracteres para o campo de Trademark no assembly. Para mais informações, consulte a documentação para a opção de /trade[mark] em Al.exe (Assembly Linker). |
Version |
Parâmetro opcional de String . Especifica informações de versão para esse assembly. O formato de cadeia de caracteres é principal.menor.compilação.revisão. o valor padrão é 0. Para mais informações, consulte a documentação para a opção de /v[ersion] em Al.exe (Assembly Linker). |
Win32Icon |
Parâmetro opcional de String . Insere um arquivo .ico no assembly. O arquivo .ico fornece o arquivo de saída a aparência desejada em Arquivo Explorer. Este parâmetro corresponde à opção de /win32icon em Al.exe (Assembly Linker). |
Win32Resource |
Parâmetro opcional de String . Insere um recurso Win32 (arquivo de .res) no arquivo de saída. Para mais informações, consulte a documentação para a opção de /win32res em Al.exe (Assembly Linker). |
Comentários
Além dos parâmetros listados acima, esta tarefa parâmetros herda da classe de ToolTaskExtension própria, que herda da classe de ToolTask . Para obter uma lista de esses parâmetros adicionais e suas descrições, consulte Classe ToolTaskExtension (base).
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>