Propriétés MsBuild prises en charge par SharePointMsBuild properties supported by SharePoint

N’importe quel MSBuildMSBuild propriété définie dans le fichier Microsoft.VisualStudio.SharePoint.targets, le fichier projet ou le fichier utilisateur de projet peut être utilisée dans Visual StudioVisual Studio projets SharePoint.Any MSBuildMSBuild property defined in the Microsoft.VisualStudio.SharePoint.targets file, project file, or project user file can be used in Visual StudioVisual Studio SharePoint projects. En plus courantes MSBuildMSBuild propriétés fournies par le projet, SharePoint définit des propriétés supplémentaires qui sont spécifiques aux projets SharePoint.In addition to the common MSBuildMSBuild properties supplied by the project, SharePoint defines additional properties that are specific to SharePoint projects.

Pour obtenir la liste de commun MSBuildMSBuild propriétés, consultez propriétés communes des projets MSBuild.For a list of common MSBuildMSBuild properties, see Common MSBuild Project Properties. Pour obtenir une liste complète des propriétés prises en charge par votre langage de programmation, recherchez dans le .targets , le fichier projet (.csproj ou .vbproj), ou l’utilisateur de projet de fichier () csproj.user ou . vbproj.user).For a full list of the properties supported by your programming language, look in the .targets file, the project file (.csproj or .vbproj), or the project user file (csproj.user or .vbproj.user).

Propriétés MsBuild spécifiques à SharePointMsBuild properties specific to SharePoint

Le tableau suivant répertorie MSBuildMSBuild propriétés qui s’appliquent spécifiquement aux projets SharePoint dans Visual StudioVisual Studio.The following table lists MSBuildMSBuild properties that apply specifically to SharePoint projects in Visual StudioVisual Studio. D’autres propriétés existent, mais ils sont à usage interne.Other properties exist, but they are for internal use.

Nom de la propriétéProperty Name DescriptionDescription
SharePointSiteUrlSharePointSiteUrl Chaîne qui représente le URLURL sur le site SharePoint.A string that represents the URLURL to the SharePoint site.
SandboxedSolutionSandboxedSolution Valeur booléenne qui indique si la solution est une solution bac à sable.A Boolean value that indicates whether the solution is a sandboxed solution.
ActiveDeploymentConfigurationActiveDeploymentConfiguration La configuration de déploiement active.The active deployment configuration.
IncludeAssemblyInPackageIncludeAssemblyInPackage Valeur booléenne qui indique si l’assembly est inclus dans le fichier de package.A Boolean value that indicates whether the assembly is included in the package file.
PreDeploymentCommandPreDeploymentCommand Valeur de chaîne qui représente la commande à exécuter dans l’étape de commande de prédéploiement.A string value that represents the command to execute in the pre-deployment command step.
PostDeploymentCommandPostDeploymentCommand Valeur de chaîne qui représente la commande à exécuter dans l’étape de commande de post-déploiement.A string value that represents the command to execute in the post-deployment command step.
CustomBeforeSharePointTargetsCustomBeforeSharePointTargets Chaîne qui représente le chemin d’accès d’un MSBuildMSBuild fichier de cibles.A string that represents the path of a MSBuildMSBuild targets file. Si le fichier de cibles existe et est défini, il est importé avant toutes les données cibles SharePoint.If the targets file exists and is defined, it is imported before any SharePoint targets data. Cette propriété vous permet de personnaliser le processus de package en prédéfinissant des propriétés relatives à l’empaquetage sans modifier le fichier de cibles SharePoint expédié, mais le fichier de cibles s’applique toujours à tous les projets SharePoint.This property lets you customize the package process by predefining packaging-related properties without modifying the shipped SharePoint targets file, yet the targets file still applies to all SharePoint projects.
CustomAfterSharePointTargetsCustomAfterSharePointTargets Chaîne qui représente le chemin d’accès d’un MSBuildMSBuild fichier de cibles.A string that represents the path of a MSBuildMSBuild targets file. Si le fichier de cibles existe et est défini, il est importé après toutes les données de cibles SharePoint.If the targets file exists and is defined, it is imported after all of the SharePoint targets data. Cette propriété vous permet de personnaliser le processus de package en substituant les propriétés relatives à l’empaquetage et les cibles sans avoir à modifier le fichier de cibles SharePoint expédié, mais le fichier de cibles s’applique toujours à tous les projets SharePoint.This property lets you customize the package process by overriding packaging-related properties and targets without having to modify the shipped SharePoint targets file, yet the targets file still applies to all SharePoint projects.
LayoutPathLayoutPath Chaîne qui représente le répertoire racine où chacun des fichiers à empaqueter sont temporairement placés avant d’être ajoutés à la .wsp fichier.A string that represents the root directory where each of the files to be packaged are temporarily placed before they are added to the .wsp file. Ce chemin d’accès peut être utile de savoir lorsque vous substituez les cibles BeforeLayout et AfterLayout pour ajouter, supprimer ou modifier des fichiers à empaqueter, car vous pouvez l’utiliser pour modifier le contenu de la .wsp fichier.This path can be useful to know when you override the BeforeLayout and AfterLayout targets to add, remove, or modify files to be packaged, because you can use it to alter the contents of the .wsp file.
BasePackagePathBasePackagePath Chaîne qui représente le dossier dans lequel le package est placé.A string that represents the folder in which the package is placed. Cette valeur utilise le répertoire de sortie du projet, telles que Bin\Debug.This value uses the output directory of the project, such as Bin\Debug.
PackageExtensionPackageExtension Chaîne qui représente l’extension de nom de fichier à ajouter au package.A string that represents the file name extension to append to the package. La valeur par défaut est wsp.The default value is wsp.
AssemblyDeploymentTargetAssemblyDeploymentTarget Chaîne qui représente l’emplacement où l’assembly de projet est déployé sur le serveur SharePoint.A string that represents the location where the project assembly is deployed on the SharePoint server. Sa valeur est GlobalAssemblyCache (valeur par défaut) ou WebApplication.Its value is either GlobalAssemblyCache (the default) or WebApplication. Cette propriété peut également être définie dans la fenêtre Propriétés.This property can also be set in the Properties window.
PackageWithValidationPackageWithValidation Valeur booléenne qui spécifie si une validation est effectuée avant l’empaquetage.A Boolean value that specifies whether validation is performed before packaging. Cette propriété vous permet d’ignorer les erreurs de validation lors de la création de Packages.This property lets you ignore validation errors while building Packages.
ValidatePackageDependsOnValidatePackageDependsOn Chaîne qui définit des cibles supplémentaires à exécuter avant la cible ValidatePackage.A string that defines additional targets to execute before the ValidatePackage target.
TokenReplacementFileExensionsTokenReplacementFileExensions Chaîne qui définit les fichiers qui ont les jetons sont remplacés lors de l’empaquetage.A string that defines the files that have their tokens replaced during packaging.

Utilisez les propriétés MsBuild dans la page de propriétésUse MsBuild properties in the properties page

Pour une flexibilité, au lieu d’utiliser des chaînes codées en dur dans le ligne de commande de prédéploiement et ligne de commande de post-déploiement cases dans la page de propriétés de SharePoint, vous pouvez utiliser SharePoint propriétés en tant qu’arguments.For flexibility, instead of using hard-coded strings in the Pre-deployment Command Line and Post-deployment Command Line boxes on the SharePoint Properties page, you can use the SharePoint properties as arguments. Par exemple, au lieu de spécifier des spécifique URLURL chaîne pour le site SharePoint, vous pouvez utiliser $(SharePointSiteUrl).For example, instead of specifying a specific URLURL string for the SharePoint site, you can instead use $(SharePointSiteUrl).

Note

Vous pouvez utiliser la MSBuildMSBuild syntaxe de variable $( propertyName ) ou la syntaxe de variable d’environnement % propertyName % Pour spécifier une propriété.You can use either the MSBuildMSBuild variable syntax $(propertyName) or the environment variable syntax %propertyName% to specify a property.

Voir aussiSee also

Informations de référence sur MSBuildMSBuild Reference