Partager via

SGen (tâche)

  • Article

Crée un assembly de sérialisation XML pour les types dans l’assembly spécifié. Cette tâche encapsule l’outil XML Serializer Generator (Sgen.exe). Pour plus d’informations, consultez Outil XML Serializer Generator (Sgen.exe).

Paramètres

Le tableau ci-dessous décrit les paramètres de la tâche SGen .

Paramètre Description
BuildAssemblyName Paramètre String requis.

Assembly pour lequel le code de sérialisation doit être généré.
BuildAssemblyPath Paramètre String requis.

Chemin de l’assembly pour lequel le code de sérialisation doit être généré.
DelaySign Paramètre Boolean facultatif.

Si true, indique que vous souhaitez placer uniquement la clé publique dans l’assembly. Si false, indique que vous souhaitez obtenir un assembly complètement signé.

Ce paramètre n’a aucun effet, sauf s’il est utilisé avec les paramètres KeyFile ou KeyContainer.
KeyContainer Paramètre String facultatif.

Spécifie un conteneur qui contient une paire de clés. Cela signe l’assembly en insérant une clé publique dans le manifeste d’assembly. La tâche signe ensuite l’assembly définitif à l’aide de la clé privée.
KeyFile Paramètre String facultatif.

Spécifie une paire de clés ou une clé publique pour signer un assembly. Le compilateur insère la clé publique dans le manifeste d'assembly, puis signe l'assembly final avec la clé privée.
Platform Paramètre String facultatif.

Obtient ou définit la plateforme du compilateur utilisée pour générer l’assembly de sortie. Ce paramètre peut avoir la valeur x86, x64 ou anycpu. La valeur par défaut est anycpu.
References Paramètre String[] facultatif.

Spécifie les assemblys référencés par les types qui requièrent la sérialisation XML.
SdkToolsPath Paramètre String facultatif.

Spécifie le chemin des outils du SDK, comme resgen.exe.
SerializationAssembly Paramètre de sortie ITaskItem[] facultatif.

Contient l’assembly de sérialisation généré.
SerializationAssemblyName Paramètre String facultatif.

Spécifie le nom de l’assembly de sérialisation généré.
ShouldGenerateSerializer Paramètre Boolean requis.

Si true, la tâche SGen doit générer un assembly de sérialisation.
Timeout Paramètre Int32 facultatif.

Spécifie le délai, en millisecondes, après lequel l’exécutable de la tâche est arrêté. La valeur par défaut est Int.MaxValue, ce qui indique qu’il n’existe aucun délai d’expiration.
ToolPath Paramètre String facultatif.

Spécifie l’emplacement à partir duquel la tâche chargera le fichier exécutable sous-jacent (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 MSBuild.
Types Paramètre String[] facultatif.

Obtient ou définit une liste de types spécifiques pour lesquels générer le code de sérialisation. SGen générera le code de sérialisation uniquement pour ces types.
UseProxyTypes Paramètre Boolean requis.

Si true, la tâche SGen génère du code de sérialisation uniquement pour les types de proxy de service web XML.

Paramètres ToolTaskExtension

Cette tâche hérite de la classe ToolTaskExtension, laquelle hérite de la classe ToolTask, qui hérite elle-même de la classe Task. Cette chaîne d'héritage ajoute plusieurs paramètres aux tâches qui en dérivent.

Le tableau ci-dessous décrit les paramètres des classes de base :

Paramètre Description
EchoOff Paramètre bool facultatif.

Quand la valeur est true, cette tâche passe /Q à la ligne de commande cmd.exe de telle manière que cette dernière ne soit pas copiée dans stdout.
EnvironmentVariables Paramètres de tableau String facultatif.

Tableau de définitions de variables d’environnement, séparées par des points-virgules. Chaque définition devrait spécifier un nom et une valeur de variable d’environnement séparés par un signe égal. Ces variables sont transmises à l'exécutable généré en plus ou en remplacement sélectif du bloc environnement normal. Par exemple : Variable1=Value1;Variable2=Value2.
ExitCode Paramètre en lecture seule de sortie Int32 facultatif.

Spécifie le code de sortie fourni par la commande exécutée. Si la tâche a journalisé des erreurs, alors que le processus avait un code de sortie de 0 (réussite), ce paramètre prend la valeur -1.
LogStandardErrorAsError Paramètre bool facultatif.

Si la valeur est true, tous les messages reçus sur le flux d'erreur standard sont journalisés en tant qu'erreurs.
StandardErrorImportance Paramètre String facultatif.

Importance avec laquelle le texte doit être enregistré dans le flux d’erreur standard.
StandardOutputImportance Paramètre String facultatif.

Importance avec laquelle le texte doit être enregistré dans le flux de sortie standard.
Timeout Paramètre Int32 facultatif.

Spécifie le délai, en millisecondes, après lequel l’exécutable de la tâche est arrêté. La valeur par défaut est Int.MaxValue, ce qui indique qu’il n’existe aucun délai d’expiration. Délai d’expiration en millisecondes.
ToolExe Paramètre string facultatif.

Les projets peuvent l'implémenter pour remplacer un ToolName. Les tâches peuvent le remplacer pour préserver le ToolName.
ToolPath Paramètre string facultatif.

Spécifie l’emplacement à partir duquel la tâche charge le fichier exécutable sous-jacent. Si ce paramètre n'est pas spécifié, la tâche utilise le chemin d'installation du SDK qui correspond à la version de l'infrastructure qui exécute MSBuild.
UseCommandProcessor Paramètre bool facultatif.

Quand la valeur est true, cette tâche crée un fichier de commandes pour la ligne de commande et l'exécute à l'aide de l'interpréteur de commandes au lieu d'exécuter la commande directement.
YieldDuringToolExecution Paramètre bool facultatif.

Quand la valeur est true, cette tâche donne le nœud quand sa tâche s'exécute.

Voir aussi