AL (Assembly Linker), tâcheAL (Assembly Linker) task

La tâche AL encapsule AL.exe, un outil distribué avec le Kit de développement logiciel WindowsWindows Software Development Kit (SDK).The AL task wraps AL.exe, a tool that is distributed with the Kit de développement logiciel WindowsWindows Software Development Kit (SDK). L’outil Assembly Linker sert à créer un assembly avec un manifeste à partir d’un ou plusieurs fichiers qui sont soit des modules, soit des fichiers de ressources.This Assembly Linker tool is used to create an assembly with a manifest from one or more files that are either modules or resource files. Les compilateurs et les environnements de développement pouvant déjà fournir ces fonctionnalités, il n’est généralement pas nécessaire d’utiliser cette tâche directement.Compilers and development environments might already provide these capabilities, so it is often not necessary to use this task directly. Assembly Linker est très utile aux développeurs ayant besoin de créer un assembly unique à partir de plusieurs fichiers de composant, tels que ceux qui peuvent être générés par le développement en plusieurs langages.The Assembly Linker is most useful to developers needing to create a single assembly from multiple component files, such as those that might be produced from mixed-language development. Cette tâche ne combine pas les modules dans un fichier d’assembly unique. Les modules individuels doivent toujours être distribués et disponibles pour que l’assembly résultant se charge correctement.This task does not combine the modules into a single assembly file; the individual modules must still be distributed and available in order for the resulting assembly to load correctly. Pour plus d’informations sur AL.exe, consultez Al.exe (Assembly Linker).For more information on AL.exe, see Al.exe (Assembly Linker).

ParamètresParameters

Le tableau ci-dessous décrit les paramètres de la tâche AL .The following table describes the parameters of the AL task.

ParamètreParameter DescriptionDescription
AlgorithmID Paramètre String facultatif.Optional String parameter.

Spécifie un algorithme de hachage de tous les fichiers dans un assembly multifichier, à l'exception du fichier qui contient le manifeste d'assembly.Specifies an algorithm to hash all files in a multifile assembly except the file that contains the assembly manifest. Pour plus d’informations, consultez la documentation relative à l’option /algid dans Al.exe (Assembly Linker).For more information, see the documentation for the /algid option in Al.exe (Assembly Linker).
BaseAddress Paramètre String facultatif.Optional String parameter.

Spécifie l'adresse de chargement d'une DLL sur l'ordinateur de l'utilisateur au moment de l'exécution.Specifies the address at which a DLL will be loaded on the user's computer at run time. Le chargement des applications est plus rapide si vous spécifiez l’adresse de base des DLL au lieu de laisser le système d’exploitation déplacer les DLL dans l’espace de processus.Applications load faster if you specify the base address of the DLLs, rather than letting the operating system relocate the DLLs in the process space. Ce paramètre correspond à l’option /baseaddress.This parameter corresponds to the /baseaddress.
CompanyName Paramètre String facultatif.Optional String parameter.

Spécifie une chaîne pour le champ Company de l'assembly.Specifies a string for the Company field in the assembly. Pour plus d’informations, consultez la documentation relative à l’option /comp[any] dans Al.exe (Assembly Linker).For more information, see the documentation for the /comp[any] option in Al.exe (Assembly Linker).
Configuration Paramètre String facultatif.Optional String parameter.

Spécifie une chaîne pour le champ Configuration de l'assembly.Specifies a string for the Configuration field in the assembly. Pour plus d’informations, consultez la documentation relative à l’option /config[uration] dans Al.exe (Assembly Linker).For more information, see the documentation for the /config[uration] option in Al.exe (Assembly Linker).
Copyright Paramètre String facultatif.Optional String parameter.

Spécifie une chaîne pour le champ Copyright de l'assembly.Specifies a string for the Copyright field in the assembly. Pour plus d’informations, consultez la documentation relative à l’option /copy[right] dans Al.exe (Assembly Linker).For more information, see the documentation for the /copy[right] option in Al.exe (Assembly Linker).
Culture Paramètre String facultatif.Optional String parameter.

Spécifie la chaîne de culture à associer à l'assembly.Specifies the culture string to associate with the assembly. Pour plus d’informations, consultez la documentation relative à l’option /c[ulture] dans Al.exe (Assembly Linker).For more information, see the documentation for the /c[ulture] option in Al.exe (Assembly Linker).
DelaySign Paramètre Boolean facultatif.Optional Boolean parameter.

true pour placer uniquement la clé publique dans l’assembly ; false pour signer complètement l’assembly.true to place only the public key in the assembly; false to fully sign the assembly. Pour plus d’informations, consultez la documentation relative à l’option /delay[sign] dans Al.exe (Assembly Linker).For more information, see the documentation for the /delay[sign] option in Al.exe (Assembly Linker).
Description Paramètre String facultatif.Optional String parameter.

Spécifie une chaîne pour le champ Description de l'assembly.Specifies a string for the Description field in the assembly. Pour plus d’informations, consultez la documentation relative à l’option /descr[iption] dans Al.exe (Assembly Linker).For more information, see the documentation for the /descr[iption] option in Al.exe (Assembly Linker).
EmbedResources Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Incorpore les ressources spécifiées dans l’image qui contient le manifeste d’assembly.Embeds the specified resources in the image that contains the assembly manifest. Cette tâche copie le contenu du fichier de ressources dans l’image.This task copies the contents of the resource file into the image. Les éléments passés dans ce paramètre peuvent avoir des métadonnées facultatives associées appelées LogicalName et Access.The items passed in to this parameter may have optional metadata attached to them called LogicalName and Access. Les métadonnées LogicalName sont utilisées pour spécifier l’identificateur interne de la ressource.The LogicalName metadata is used to specify the internal identifier for the resource. Vous pouvez affecter la valeur private aux métadonnées Access pour rendre la ressource invisible à d’autres assemblys.The Access metadata can be set to private in order to make the resource not visible to other assemblies. Pour plus d’informations, consultez la documentation relative à l’option /embed[resource] dans Al.exe (Assembly Linker).For more information, see the documentation for the /embed[resource] option in Al.exe (Assembly Linker).
EvidenceFile Paramètre String facultatif.Optional String parameter.

Incorpore le fichier spécifié dans l’assembly avec le nom de ressource Security.Evidence.Embeds the specified file in the assembly with the resource name of Security.Evidence.

Vous ne pouvez pas utiliser Security.Evidence pour ses ressources standard.You cannot use Security.Evidence for regular resources. Ce paramètre correspond à l’option /e[vidence] dans Al.exe (Assembly Linker).This parameter corresponds to the /e[vidence] option in Al.exe (Assembly Linker).
ExitCode Paramètre en lecture seule de sortie Int32 facultatif.Optional Int32 output read-only parameter.

Spécifie le code de sortie fourni par la commande exécutée.Specifies the exit code provided by the executed command.
FileVersion Paramètre String facultatif.Optional String parameter.

Spécifie une chaîne pour le champ File Version de l'assembly.Specifies a string for the File Version field in the assembly. Pour plus d’informations, consultez la documentation relative à l’option /fileversion dans Al.exe (Assembly Linker).For more information, see the documentation for the /fileversion option in Al.exe (Assembly Linker).
Flags Paramètre String facultatif.Optional String parameter.

Spécifie une valeur pour le champ Flags de l'assembly.Specifies a value for the Flags field in the assembly. Pour plus d’informations, consultez la documentation relative à l’option /flags dans Al.exe (Assembly Linker).For more information, see the documentation for the /flags option in Al.exe (Assembly Linker).
GenerateFullPaths Paramètre Boolean facultatif.Optional Boolean parameter.

Force la tâche à utiliser le chemin absolu de tout fichier signalé dans un message d’erreur.Causes the task to use the absolute path for any files that are reported in an error message. Ce paramètre correspond à l’option /fullpaths dans Al.exe (Assembly Linker).This parameter corresponds to the /fullpaths option in Al.exe (Assembly Linker).
KeyContainer Paramètre String facultatif.Optional String parameter.

Spécifie un conteneur qui contient une paire de clés.Specifies a container that holds a key pair. Cela signe l'assembly (lui donne un nom fort) en insérant une clé publique dans le manifeste d'assembly.This will sign the assembly (give it a strong name) by inserting a public key into the assembly manifest. La tâche signe ensuite l’assembly définitif à l’aide de la clé privée.The task will then sign the final assembly with the private key. Pour plus d’informations, consultez la documentation relative à l’option /keyn[ame] dans Al.exe (Assembly Linker).For more information, see the documentation for the /keyn[ame] option in Al.exe (Assembly Linker).
KeyFile Paramètre String facultatif.Optional String parameter.

Spécifie un fichier qui contient une paire de clés ou juste une clé publique pour signer un assembly.Specifies a file that contains a key pair or just a public key to sign an assembly. Le compilateur insère la clé publique dans le manifeste d'assembly, puis signe l'assembly final avec la clé privée.The compiler inserts the public key in the assembly manifest and then signs the final assembly with the private key. Pour plus d’informations, consultez la documentation relative à l’option /keyf[ile] dans Al.exe (Assembly Linker).For more information, see the documentation for the /keyf[ile] option in Al.exe (Assembly Linker).
LinkResources Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Lie les fichiers de ressources spécifiés à un assembly.Links the specified resource files to an assembly. La ressource est intégrée à l’assembly, mais le fichier n’est pas copié.The resource becomes part of the assembly, but the file is not copied. Les éléments passés dans ce paramètre peuvent avoir des métadonnées facultatives associées appelées LogicalName, Target et Access.The items passed in to this parameter may have optional metadata attached to them called LogicalName, Target, and Access. Les métadonnées LogicalName sont utilisées pour spécifier l’identificateur interne de la ressource.The LogicalName metadata is used to specify the internal identifier for the resource. Les métadonnées Target peuvent spécifier le chemin et le nom de fichier où la tâche copie le fichier, avant de compiler ce nouveau fichier dans l’assembly.The Target metadata can specify the path and filename to which the task copies the file, after which it compiles this new file into the assembly. Vous pouvez affecter la valeur private aux métadonnées Access pour rendre la ressource invisible à d’autres assemblys.The Access metadata can be set to private in order to make the resource not visible to other assemblies. Pour plus d’informations, consultez la documentation relative à l’option /link[resource] dans Al.exe (Assembly Linker).For more information, see the documentation for the /link[resource] option in Al.exe (Assembly Linker).
MainEntryPoint Paramètre String facultatif.Optional String parameter.

Spécifie le nom complet (class.method) de la méthode à utiliser comme point d’entrée lors de la conversion d’un module en fichier exécutable.Specifies the fully qualified name (class.method) of the method to use as an entry point when converting a module to an executable file. Ce paramètre correspond à l’option /main dans Al.exe (Assembly Linker).This parameter corresponds to the /main option in Al.exe (Assembly Linker).
OutputAssembly Paramètre de sortie ITaskItem obligatoire.Required ITaskItem output parameter.

Spécifie le nom du fichier généré par cette tâche.Specifies the name of the file generated by this task. Ce paramètre correspond à l’option /out dans Al.exe (Assembly Linker).This parameter corresponds to the /out option in Al.exe (Assembly Linker).
Platform Paramètre String facultatif.Optional String parameter.

Limite la plateforme sur laquelle ce code peut s’exécuter. Doit correspondre à l’une des valeurs suivantes : x86, Itanium, x64 ou anycpu.Limits which platform this code can run on; must be one of x86, Itanium, x64, or anycpu. La valeur par défaut est anycpu.The default is anycpu. Ce paramètre correspond à l’option /platform dans Al.exe (Assembly Linker).This parameter corresponds to the /platform option in Al.exe (Assembly Linker).
ProductName Paramètre String facultatif.Optional String parameter.

Spécifie une chaîne pour le champ Product de l'assembly.Specifies a string for the Product field in the assembly. Pour plus d’informations, consultez la documentation relative à l’option /prod[uct] dans Al.exe (Assembly Linker).For more information, see the documentation for the /prod[uct] option in Al.exe (Assembly Linker).
ProductVersion Paramètre String facultatif.Optional String parameter.

Spécifie une chaîne pour le champ ProductVersion de l'assembly.Specifies a string for the ProductVersion field in the assembly. Pour plus d’informations, consultez la documentation relative à l’option /productv[ersion] dans Al.exe (Assembly Linker).For more information, see the documentation for the /productv[ersion] option in Al.exe (Assembly Linker).
ResponseFiles Paramètre String[] facultatif.Optional String[] parameter.

Spécifie les fichiers réponse qui contiennent des options supplémentaires à passer à Assembly Linker.Specifies the response files that contain additional options to pass through to the Assembly Linker.
SdkToolsPath Paramètre String facultatif.Optional String parameter.

Spécifie le chemin des outils du SDK, comme resgen.exe.Specifies the path to the SDK tools, such as resgen.exe.
SourceModules Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Un ou plusieurs modules à compiler dans un assembly.One or more modules to be compiled into an assembly. Les modules seront répertoriés dans le manifeste de l’assembly résultant, et devront toujours être distribués et disponibles pour que l’assembly se charge.The modules will be listed in the manifest of the resulting assembly, and will still need to distributed and available in order for the assembly to load. Les éléments passés dans ce paramètre peuvent avoir des métadonnées supplémentaires appelées Target, qui spécifient le chemin et le nom de fichier où la tâche copie le fichier, avant de compiler ce nouveau fichier dans l’assembly.The items passed into this parameter may have additional metadata called Target, which specifies the path and filename to which the task copies the file, after which it compiles this new file into the assembly. Pour plus d’informations, consultez la documentation relative Al.exe (Assembly Linker).For more information, see the documentation for Al.exe (Assembly Linker). Ce paramètre correspond à la liste des modules transmis à Al.exe sans commutateur spécifique.This parameter corresponds to the list of modules passed into Al.exe without a specific switch.
TargetType Paramètre String facultatif.Optional String parameter.

Spécifie le format du fichier de sortie : library (bibliothèque de codes), exe (application console) ou win (application Windows).Specifies the file format of the output file: library (code library), exe (console application), or win (Windows-based application). La valeur par défaut est library.The default is library. Ce paramètre correspond à l’option /t[arget] dans Al.exe (Assembly Linker).This parameter corresponds to the /t[arget] option in Al.exe (Assembly Linker).
TemplateFile Paramètre String facultatif.Optional String parameter.

Spécifie l’assembly à partir duquel hériter de toutes les métadonnées d’assembly, à l’exception du champ Culture.Specifies the assembly from which to inherit all assembly metadata, except the culture field. L’assembly spécifié doit avoir un nom fort.The specified assembly must have a strong name.

Un assembly créé avec le paramètre TemplateFile est un assembly satellite.An assembly that you create with the TemplateFile parameter will be a satellite assembly. Ce paramètre correspond à l’option /template dans Al.exe (Assembly Linker).This parameter corresponds to the /template option in Al.exe (Assembly Linker).
Timeout Paramètre Int32 facultatif.Optional Int32 parameter.

Spécifie le délai, en millisecondes, après lequel l’exécutable de la tâche est arrêté.Specifies the amount of time, in milliseconds, after which the task executable is terminated. La valeur par défaut est Int.MaxValue, ce qui indique qu’il n’existe aucun délai d’expiration.The default value is Int.MaxValue, indicating that there is no time out period.
Title Paramètre String facultatif.Optional String parameter.

Spécifie une chaîne pour le champ Title de l'assembly.Specifies a string for the Title field in the assembly. Pour plus d’informations, consultez la documentation relative à l’option /title dans Al.exe (Assembly Linker).For more information, see the documentation for the /title option in Al.exe (Assembly Linker).
ToolPath Paramètre String facultatif.Optional String parameter.

Spécifie l’emplacement à partir duquel la tâche chargera le fichier exécutable sous-jacent (Al.exe).Specifies the location from where the task will load the underlying executable file (Al.exe). Si vous ne spécifiez pas ce paramètre, la tâche utilise le chemin d’installation du SDK correspondant à la version du framework qui exécute MSBuildMSBuild.If this parameter is not specified, the task uses the SDK installation path corresponding to the version of the framework that is running MSBuildMSBuild.
Trademark Paramètre String facultatif.Optional String parameter.

Spécifie une chaîne pour le champ Trademark de l'assembly.Specifies a string for the Trademark field in the assembly. Pour plus d’informations, consultez la documentation relative à l’option /trade[mark] dans Al.exe (Assembly Linker).For more information, see the documentation for the /trade[mark] option in Al.exe (Assembly Linker).
Version Paramètre String facultatif.Optional String parameter.

Spécifie les informations de version pour cet assembly.Specifies the version information for this assembly. Le format de la chaîne est principale.mineure.build.révision.The format of the string is major.minor.build.revision. La valeur par défaut est 0.The default value is 0. Pour plus d’informations, consultez la documentation relative à l’option /v[ersion] dans Al.exe (Assembly Linker).For more information, see the documentation for the /v[ersion] option in Al.exe (Assembly Linker).
Win32Icon Paramètre String facultatif.Optional String parameter.

Insère un fichier .ico dans l’assembly.Inserts an .ico file in the assembly. Le fichier .ico donne au fichier de sortie l’aspect souhaité dans l’Explorateur de fichiers.The .ico file gives the output file the desired appearance in File Explorer. Ce paramètre correspond à l’option /win32icon dans Al.exe (Assembly Linker).This parameter corresponds to the /win32icon option in Al.exe (Assembly Linker).
Win32Resource Paramètre String facultatif.Optional String parameter.

Insère une ressource Win32 (fichier .res) dans le fichier de sortie.Inserts a Win32 resource (.res file) in the output file. Pour plus d’informations, consultez la documentation relative à l’option /win32res dans Al.exe (Assembly Linker).For more information, see the documentation for the /win32res option in Al.exe (Assembly Linker).

NotesRemarks

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe ToolTaskExtension, qui elle-même hérite de la classe ToolTask.In addition to the parameters listed above, this task inherits parameters from the ToolTaskExtension class, which itself inherits from the ToolTask class. Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base ToolTaskExtension.For a list of these additional parameters and their descriptions, see ToolTaskExtension base class.

ExempleExample

L’exemple suivant crée un assembly avec les options spécifiées.The following example creates an assembly with the specified options.

<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>  

Voir aussiSee also

Informations de référence sur les tâches Task reference
TâchesTasks