AL (do Assembly vinculador) tarefas

A tarefa de AL encapsula AL.exe, uma ferramenta que é distribuída com o Windows Software Development Kit (SDK). Esta ferramenta do vinculador do assembly é 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 já podem fornecer esses recursos, muitas vezes não é necessário usar essa tarefa diretamente. O vinculador de assembly é mais útil para desenvolvedores que precisam criar um conjunto único de vários arquivos de componente, sistema autônomo aqueles que pode ser produzida do desenvolvimento de linguagem misto. Esta tarefa não combina os módulos em um arquivo único assembly; 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 Vinculador do conjunto (AL.exe) .

Parâmetros

A tabela a seguir descreve os parâmetros do AL tarefa.

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 no Vinculador do conjunto (AL.exe) .
BaseAddress	Opcional String parâmetro. Especifica o endereço no qual uma DLL será carregada no computador do usuário em time 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] em Vinculador do conjunto (AL.exe) .
CompanyName	Opcional String parâmetro. Especifica uma seqüência de caracteres para o Company campo do assembly. Para obter mais informações, consulte a documentação para o /comp[any] opção no Vinculador do conjunto (AL.exe) .
Configuration	Opcional String parâmetro. Especifica uma seqüência de caracteres para o Configuration campo do assembly. Para obter mais informações, consulte a documentação para o /config[uration] opção no Vinculador do conjunto (AL.exe) .
Copyright	Opcional String parâmetro. Especifica uma seqüência de caracteres para o Copyright campo do assembly. Para obter mais informações, consulte a documentação para o /copy[right] opção no Vinculador do conjunto (AL.exe) .
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 no Vinculador do conjunto (AL.exe) .
DelaySign	Opcional Boolean parâmetro. true para colocar somente a chave pública no assembly; false para assinar o conjunto totalmente. Para obter mais informações, consulte a documentação para o /delay[sign] opção no Vinculador do conjunto (AL.exe) .
Description	Opcional String parâmetro. Especifica uma seqüência de caracteres para o Description campo do assembly. Para obter mais informações, consulte a documentação para o /descr[iption] opção no Vinculador do conjunto (AL.exe) .
EmbedResources	Opcional ITaskItem[] parâmetro. Incorpora os recursos especificados na imagem que contém o manifesto do assembly. Esta tarefa copia o Sumário do arquivo de recurso para a imagem. Os itens passados para esse parâmetro podem ter metadados opcionais anexados a eles chamado LogicalName e Access. The LogicalName metadados é usado para especificar o identificador interno para o recurso. The Access metadados podem ser definido como private Para tornar o recurso não estiver visível para outros assemblies. Para obter mais informações, consulte a documentação para o /embed[resource] opção no Vinculador do conjunto (AL.exe) .
EvidenceFile	Opcional String parâmetro. Incorpora o arquivo especificado no conjunto de módulos (assembly) com o nome do recurso de Security.Evidence. Não é possível usar Security.Evidence para recursos regulares. Este parâmetro corresponde ao /e[vidence] opção no Vinculador do conjunto (AL.exe) .
ExitCode	Opcional Int32 parâmetro somente de saída. Especifica o código de sair fornecido pelo comando executado.
FileVersion	Opcional String parâmetro. Especifica uma seqüência de caracteres para o File Version campo do assembly. Para obter mais informações, consulte a documentação para o /fileversion opção no Vinculador do conjunto (AL.exe) .
Flags	Opcional String parâmetro. Especifica um valor para o Flags campo do assembly. Para obter mais informações, consulte a documentação para o /flags opção no Vinculador do conjunto (AL.exe) .
GenerateFullPaths	Opcional Boolean parâmetro. Faz com que a tarefa de usar o caminho absoluto para arquivos que são reportados em uma mensagem de erro. Este parâmetro corresponde ao /fullpaths opção no Vinculador do conjunto (AL.exe) .
KeyContainer	Opcional String parâmetro. Especifica um contêiner que contém um par de chaves. Isso irá assinar uma assembly (dar um nome forte) inserindo uma chave pública no manifesto do assembly. A tarefa será, em seguida, assinar o conjunto final com a chave particular. Para obter mais informações, consulte a documentação para o /keyn[ame] opção no Vinculador do conjunto (AL.exe) .
KeyFile	Opcional String parâmetro. Especifica um arquivo que contém um emparelhar 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 no Vinculador do conjunto (AL.exe) .
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 esse parâmetro podem ter metadados opcionais anexados a eles chamado LogicalName, Target, e Access. The LogicalName metadados é usado para especificar o identificador interno para o recurso. The Target metadados podem especificar o caminho e nome do arquivo ao qual a tarefa copia o arquivo, após o qual ele compila esse novo arquivo no assembly. The Access metadados podem ser definido como private Para tornar o recurso não estiver visível para outros assemblies. Para obter mais informações, consulte a documentação para o /link[resource] opção no Vinculador do conjunto (AL.exe) .
MainEntryPoint	Opcional String parâmetro. Especifica o nome totalmente qualificado (classe.Method) do método para usar sistema autônomo um ponto de entrada durante a conversão de um módulo em um arquivo executável. Este parâmetro corresponde ao /main opção no Vinculador do conjunto (AL.exe) .
OutputAssembly	Necessário ITaskItem parâmetro de saída. Especifica o nome do arquivo gerado por essa tarefa. Este parâmetro corresponde ao /out opção no Vinculador do conjunto (AL.exe) .
Platform	Opcional String parâmetro. Limites que plataforma este código pode ser executado em; deve ser um dos x86, Itanium, x64, ou anycpu. O padrão é anycpu. Este parâmetro corresponde ao /platform opção no Vinculador do conjunto (AL.exe) .
ProductName	Opcional String parâmetro. Especifica uma seqüência de caracteres para o Product campo do assembly. Para obter mais informações, consulte a documentação para o /prod[uct] opção no Vinculador do conjunto (AL.exe) .
ProductVersion	Opcional String parâmetro. Especifica uma seqüência de caracteres para o ProductVersion campo do assembly. Para obter mais informações, consulte a documentação para o /productv[ersion] opção no Vinculador do conjunto (AL.exe) .
ResponseFiles	Opcional String[] parâmetro. Especifica os arquivos de resposta que contém opções adicionais para passar para o vinculador de assembly.
SourceModules	Opcional ITaskItem[] parâmetro. Um ou mais módulos a serem compilados em um assembly. Os módulos serão listados no manifesto do assembly resultante e ainda serão necessário disponível para o assembly carregar e distribuídas. Os itens passados para este parâmetro podem ter metadados adicionais chamado Target, que especifica o caminho e nome do arquivo ao qual a tarefa copia o arquivo, após o qual ele compila esse novo arquivo no assembly. Para obter mais informações, consulte a documentação de Vinculador do conjunto (AL.exe) . Este parâmetro corresponde à lista de módulos passados na Al.exe sem um comutador específico.
TargetType	Opcional String parâmetro. Especifica o formato de arquivo do arquivo de saída: library (biblioteca de código) exe (aplicativo do console), ou win (Aplicativo baseado no Windows). O padrão é library. Este parâmetro corresponde ao /t[arget] opção no Vinculador do conjunto (AL.exe) .
TemplateFile	Opcional String parâmetro. Especifica o conjunto do qual herdar todos os metadados do assembly, exceto o campo de cultura. O assembly especificado deve ter um nome forte. Um assembly que você cria com o TemplateFile parâmetro será um asssembly satélite. Este parâmetro corresponde ao /template opção no Vinculador do conjunto (AL.exe) .
Timeout	Opcional Int32 parâmetro. Especifica a quantidade de time, 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 time limite.
Title	Opcional String parâmetro. Especifica uma seqüência de caracteres para o Title campo do assembly. Para obter mais informações, consulte a documentação para o /title opção no Vinculador do conjunto (AL.exe) .
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 utiliza o caminho de instalação do SDK correspondente à versão do estrutura que está executando o MSBuild.
Trademark	Opcional String parâmetro. Especifica uma seqüência de caracteres para o Trademark campo do assembly. Para obter mais informações, consulte a documentação para o /trade[mark] opção no Vinculador do conjunto (AL.exe) .
Version	Opcional String parâmetro. Especifica as informações de versão para este assembly. O formato da seqüência de caracteres é Major.minor.compilação.Revision. O valor padrão é 0. Para obter mais informações, consulte a documentação para o /v[ersion] opção no Vinculador do conjunto (AL.exe) .
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 ao /win32icon opção no Vinculador do conjunto (AL.exe) .
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 no Vinculador do conjunto (AL.exe) .

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