SGen, tâcheSGen Task

Crée un assembly de sérialisation XML pour les types dans l’assembly spécifié.Creates an XML serialization assembly for types in the specified assembly. Cette tâche encapsule l’outil XML Serializer Generator (Sgen.exe).This task wraps the XML Serializer Generator Tool (Sgen.exe). Pour plus d’informations, consultez Outil XML Serializer Generator (Sgen.exe).For more information, see XML Serializer Generator Tool (Sgen.exe).

ParamètresParameters

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

ParamètreParameter DescriptionDescription
BuildAssemblyName Paramètre String requis.Required String parameter.

Assembly pour lequel le code de sérialisation doit être généré.The assembly to generate serialization code for.
BuildAssemblyPath Paramètre String requis.Required String parameter.

Chemin de l’assembly pour lequel le code de sérialisation doit être généré.The path to the assembly to generate serialization code for.
DelaySign Paramètre Boolean facultatif.Optional Boolean parameter.

Si true, indique que vous souhaitez obtenir un assembly complètement signé.If true, specifies that you want a fully signed assembly. Si false, indique que vous souhaitez placer uniquement la clé publique dans l’assembly.If false, specifies that you only want to place the public key in the assembly.

Ce paramètre n’a aucun effet, sauf s’il est utilisé avec les paramètres KeyFile ou KeyContainer.This parameter has no effect unless used with either the KeyFile or KeyContainer parameter.
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 en insérant une clé publique dans le manifeste d’assembly.This will sign the assembly 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.
KeyFile Paramètre String facultatif.Optional String parameter.

Spécifie une paire de clés ou une clé publique pour signer un assembly.Specifies a key pair or a public key to use 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.
Platform Paramètre String facultatif.Optional String parameter.

Obtient ou définit la plateforme du compilateur utilisée pour générer l’assembly de sortie.Gets or Sets the Compiler Platform used to generate the output assembly. Ce paramètre peut avoir la valeur x86, x64 ou anycpu.This parameter can have a value of x86, x64, or anycpu. La valeur par défaut est anycpu.Default is anycpu.
References Paramètre String[] facultatif.Optional String[] parameter.

Spécifie les assemblys référencés par les types qui requièrent la sérialisation XML.Specifies the assemblies that are referenced by the types requiring XML serialization.
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.
SerializationAssembly Paramètre de sortie ITaskItem[] facultatif.Optional ITaskItem[] output parameter.

Contient l’assembly de sérialisation généré.Contains the generated serialization assembly.
SerializationAssemblyName Paramètre String facultatif.Optional String parameter.

Spécifie le nom de l’assembly de sérialisation généré.Specifies the name of the generated serialization assembly.
ShouldGenerateSerializer Paramètre Boolean requis.Required Boolean parameter.

Si true, la tâche SGen doit générer un assembly de sérialisation.If true, the SGen task should generate a serialization assembly.
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.
ToolPath Paramètre String facultatif.Optional String parameter.

Spécifie l’emplacement à partir duquel la tâche chargera le fichier exécutable sous-jacent (sgen.exe).Specifies the location from where the task will load the underlying executable file (sgen.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.
Types Paramètre String[] facultatif.Optional String[] parameter.

Obtient ou définit une liste de types spécifiques pour lesquels générer le code de sérialisation.Gets or sets a list of specific Types to generate serialization code for. SGen générera le code de sérialisation uniquement pour ces types.SGen will generate serialization code only for those types.
UseProxyTypes Paramètre Boolean requis.Required Boolean parameter.

Si true, la tâche SGen génère du code de sérialisation uniquement pour les types de proxy de service web XML.If true, the SGen task generates serialization code only for the XML Web service proxy types.

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 de leurs descriptions, consultez l’article ToolTaskExtension Base Class (Classe de base ToolTaskExtension).For a list of these additional parameters and their descriptions, see ToolTaskExtension Base Class.

Voir aussiSee Also

Task Reference (Informations de référence sur les tâches MSBuild) Task Reference
Tâches Tasks
Concepts MSBuildMSBuild Concepts