Propriétés MSBuild prises en charge par SharePoint

  • Article

Toute propriété MSBuild définie dans le fichier Microsoft.VisualStudio.SharePoint.targets, le fichier projet ou le fichier utilisateur du projet peut être utilisée dans des projets SharePoint Visual Studio. En plus des propriétés MSBuild courantes fournies par le projet, SharePoint définit des propriétés supplémentaires spécifiques pour les projets SharePoint.

Pour obtenir la liste des propriétés MSBuild courantes, consultez Propriétés de projet MSBuild courantes. Pour obtenir la liste complète des propriétés prises en charge par votre langage de programmation, consultez le fichier .targets, le fichier projet (.csproj ou .vbproj) ou le fichier utilisateur du projet (csproj.user ou .vbproj.user).

Propriétés MSBuild spécifiques de SharePoint

Le tableau suivant liste les propriétés MSBuild qui s’appliquent spécifiquement aux projets SharePoint dans Visual Studio. D’autres propriétés existent, mais elles sont destinées à un usage interne.

Nom de la propriété Description
SharePointSiteUrl Chaîne qui représente l’URL du site SharePoint.
SandboxedSolution Valeur booléenne qui indique si la solution est une solution bac à sable.
ActiveDeploymentConfiguration Configuration de déploiement active.
IncludeAssemblyInPackage Valeur booléenne qui indique si l’assembly est inclus dans le fichier de package.
PreDeploymentCommand Valeur de chaîne qui représente la commande à exécuter à l’étape de commande pré-déploiement.
PreDeploymentCommand Valeur de chaîne qui représente la commande à exécuter à l’étape de commande post-déploiement.
CustomBeforeSharePointTargets Chaîne qui représente le chemin d’un fichier de cibles MSBuild. Si le fichier de cibles existe et est défini, il est importé avant les données de cibles SharePoint. Cette propriété vous permet de personnaliser le processus de package en prédéfinissant les propriétés liées au packaging sans modifier le fichier de cibles SharePoint fourni, mais le fichier de cibles s’applique toujours à tous les projets SharePoint.
CustomAfterSharePointTargets Chaîne qui représente le chemin d’un fichier de cibles MSBuild. Si le fichier de cibles existe et est défini, il est importé après toutes les données de cibles SharePoint. Cette propriété vous permet de personnaliser le processus de package en remplaçant les propriétés et cibles liées au packaging sans modifier le fichier de cibles SharePoint fourni, mais le fichier de cibles s’applique toujours à tous les projets SharePoint.
LayoutPath Chaîne qui représente le répertoire racine où chacun des fichiers à packager est temporairement placé avant d’être ajouté au fichier .wsp. Ce chemin peut être utile pour savoir quand vous remplacez les cibles BeforeLayout et AfterLayout pour ajouter, supprimer ou modifier des fichiers à packager, car vous pouvez l’utiliser pour modifier le contenu du fichier .wsp.
BasePackagePath Chaîne qui représente le dossier dans lequel le package est placé. Cette valeur utilise le répertoire de sortie du projet, par exemple, Bin\Debug.
PackageExtension Chaîne qui représente l’extension de nom de fichier à ajouter au package. La valeur par défaut est wsp.
AssemblyDeploymentTarget Chaîne qui représente l’emplacement où l’assembly de projet est déployé sur le serveur SharePoint. Sa valeur est GlobalAssemblyCache (valeur par défaut) ou WebApplication. Cette propriété peut aussi être définie dans la fenêtre Propriétés.
PackageWithValidation Valeur booléenne qui spécifie si la validation est effectuée avant le packaging. Cette propriété vous permet d’ignorer les erreurs de validation pendant la génération de packages.
ValidatePackageDependsOn Chaîne qui définit des cibles supplémentaires à exécuter avant la cible ValidatePackage.
TokenReplacementFileExensions Chaîne qui définit les fichiers dont les jetons sont remplacés pendant le packaging.

Utiliser les propriétés MSBuild dans la page de propriétés

Pour plus de flexibilité, au lieu d’utiliser des chaînes codées en dur dans les zones Ligne de commande pré-déploiement et Ligne de commande post-déploiement de la page Propriétés SharePoint, vous pouvez utiliser les propriétés SharePoint comme des arguments. Par exemple, au lieu de spécifier une chaîne d’URL spécifique pour le site SharePoint, vous pouvez utiliser $(SharePointSiteUrl) à la place.

Notes

Vous pouvez utiliser la syntaxe de variable MSBuild $(propertyName) ou la syntaxe de variable d’environnement %propertyName% pour spécifier une propriété.

Contenu connexe