Fournir des informations d’empaquetage et de déploiement dans les éléments de projetProvide packaging and deployment information in project items

Tous les éléments de projet SharePoint dans Visual StudioVisual Studio ont des propriétés que vous pouvez utiliser pour fournir des données supplémentaires lorsque le projet est déployé sur SharePoint.All SharePoint project items in Visual StudioVisual Studio have properties that you can use to provide additional data when the project is deployed to SharePoint. Ces propriétés sont les suivantes :These properties are as follows:

  • Propriétés de la fonctionnalitéFeature Properties

  • Récepteurs de fonctionnalitéFeature Receivers

  • Références de sortie de projetProject Output References

  • Entrées de contrôle sécuriséSafe Control Entries

    Ces propriétés s’affichent dans le propriétés fenêtre.These properties appear in the Properties window.

Propriétés de fonctionnalitéFeature properties

Utilisez le propriétés de la fonctionnalité propriété pour spécifier les données qui utilise la fonctionnalité.Use the Feature Properties property to specify data that the feature uses. Données de propriétés de fonctionnalité sont un ensemble de valeurs (stockées en tant que paires clé/valeur) qui est inclus avec une fonctionnalité lorsqu’elle déploie sur SharePoint.Feature properties data is a set of values (stored as key/value pairs) that is included with a feature when it deploys to SharePoint. Une fois la fonctionnalité déployée, vous pouvez accéder aux valeurs de propriété dans votre code.After the feature is deployed, you can access the property values in your code.

Lorsque vous ajoutez une valeur de propriété de fonctionnalité à un élément de projet, la valeur est ajoutée en tant qu’élément dans le manifeste de fonctionnalité de l’élément.When you add a feature property value to a project item, the value is added as an element in the manifest of the item's feature. Dans un projet de modèle de connectivité de données métiers (BDC), par exemple, la propriété de fonctionnalité ModelFileName apparaît en tant que :In a Business Data Connectivity (BDC) model project, for example, the ModelFileName feature property appears as:

<Property Key="ModelFileName" Value="BdcModel1\BdcModel1.bdcm" />   

Après avoir défini une valeur de propriété de fonctionnalité, il est ajouté en tant qu’élément FeatureProperty dans le projet .spdata fichier.After you set a Feature Property value, it is added as a FeatureProperty element in the project's .spdata file. Pour plus d’informations sur l’accès aux propriétés dans SharePoint, consultez SPFeaturePropertyCollection, classe.For information about accessing the properties in SharePoint, see SPFeaturePropertyCollection Class.

Valeurs de propriété de fonctionnalité identiques à partir de tous les éléments de projet sont fusionnées dans le manifeste de fonctionnalité.Identical feature property values from all project items are merged together in the feature manifest. Toutefois, si deux éléments de projet différents spécifient la même clé de propriété de fonctionnalité avec des valeurs non correspondantes, une erreur de validation se produit.However, if two different project items specify the same feature property key with non-matching values, a validation error occurs.

Pour ajouter des propriétés de la fonctionnalité directement dans le fichier de fonctionnalité (.feature), appelez le Visual StudioVisual Studio méthode du modèle objet SharePoint Add.To add feature properties directly to the feature file (.feature), call the Visual StudioVisual Studio SharePoint object model method Add. Si vous utilisez cette méthode, n’oubliez pas que la même règle sur l’ajout de valeurs de propriété de fonctionnalité identiques dans les propriétés de fonctionnalité s’applique également aux propriétés ajoutées directement au fichier de fonctionnalité.If you use this method, be aware that the same rule about adding identical feature property values in Feature Properties also applies to properties added directly to the feature file.

Récepteur de fonctionnalitéFeature receiver

Récepteurs de fonctionnalité sont la fonctionnalité qui contient le code qui s’exécute lorsque certains événements se produisent à un élément de projet.Feature receivers are code that executes when certain events occur to a project item's containing feature. Par exemple, vous pouvez définir des récepteurs de fonctionnalité qui s’exécutent lorsque la fonctionnalité est installée, activée ou mis à niveau.For example, you can define feature receivers that execute when the feature is installed, activated, or upgraded. Une façon d’ajouter un récepteur de fonctionnalité consiste à ajouter directement à une fonctionnalité comme décrit dans procédure pas à pas : ajout de récepteurs d’événements de fonctionnalité.One way to add a feature receiver is to add it directly to a feature as described in Walkthrough: Add feature event receivers. Une autre méthode consiste à référencer un nom de classe de récepteur de fonctionnalité et d’un assembly dans le récepteur de fonctionnalité propriété.Another way is to reference a feature receiver class name and assembly in the Feature Receiver property.

Méthode directeDirect method

Lorsque vous ajoutez directement un récepteur de fonctionnalité à une fonctionnalité, un fichier de code est placé sous le fonctionnalité nœud dans l’Explorateur de solutions.When you add a feature receiver to a feature directly, a code file is placed under the Feature node in Solution Explorer. Lorsque vous générez votre solution SharePoint, le code se compile dans un assembly et déploie sur SharePoint.When you build your SharePoint solution, the code compiles into an assembly and deploys to SharePoint. Par défaut, les propriétés de fonctionnalité Assembly du récepteur et classe de récepteur référencer le nom de la classe et l’assembly.By default, the feature properties Receiver Assembly and Receiver Class reference the class name and assembly.

Reference (méthode)Reference method

Une autre façon d’ajouter un récepteur de fonctionnalité consiste à l’aide de la récepteur de fonctionnalité propriété d’un élément de projet pour référencer un assembly de récepteur de fonctionnalité.Another way to add a feature receiver is by using the Feature Receiver property of a project item to reference a feature receiver assembly. La valeur de propriété de récepteur de fonctionnalité a deux sous-propriétés : Assembly et nom de la classe.The Feature Receiver property value has two subproperties: Assembly and Class Name. L’assembly doit utiliser son complet, nom de « forts » et le nom de classe doivent être le nom de type complet.The assembly must use its fully-qualified, "strong" name and the class name must be the full type name. Pour plus d’informations, consultez Assemblys avec nom fort.For more information, see Strong-Named Assemblies. Après avoir déployé la solution vers SharePoint, la fonctionnalité utilise le récepteur de fonctionnalité référencée pour gérer les événements de fonctionnalité.After deploying the solution to SharePoint, the feature uses the referenced feature receiver to handle feature events.

Solution heure de création, la fonctionnalité de valeurs de propriété de récepteur dans la fonctionnalité et ses projets fusionnent pour définir les attributs ReceiverAssembly et ReceiverClass de l’élément de fonctionnalité dans le manifeste de fonctionnalité de la solution SharePoint (.wsp ) fichier.At solution build time, the feature receiver property values in the feature and its projects merge together to set the ReceiverAssembly and ReceiverClass attributes of the Feature element in the feature manifest of the SharePoint solution (.wsp) file. Par conséquent, si les valeurs de propriété Assembly et le nom de classe d’un élément de projet et une fonctionnalité sont spécifiées, les valeurs de propriété des élément et fonctionnalité de projet doivent correspondre.Therefore, if the Assembly and Class Name property values of a project item and a feature are both specified, the project item and feature property values must match. Si les valeurs ne correspondent pas, vous recevrez une erreur de validation.If the values do not match, you will receive a validation error. Si vous voulez un élément de projet pour référencer un assembly de récepteur de fonctionnalité différente de celle sa fonctionnalité, déplacez-le vers une autre fonctionnalité.If you want a project item to reference a feature receiver assembly other than the one its feature uses, move it to another feature.

Si vous référencez un assembly de récepteur de fonctionnalité qui n’est pas déjà sur le serveur, vous devez également inclure le fichier d’assembly dans le package ; Visual StudioVisual Studio ne l’ajoutez pas pour vous.If you reference a feature receiver assembly that is not already on the server, you must also include the assembly file itself in the package; Visual StudioVisual Studio does not add it for you. Lorsque vous déployez la fonctionnalité, le fichier d’assembly est copié pour que le système Global Assembly Cache (GAC)global assembly cache (GAC) ou le dossier Bin dans le répertoire physique SharePoint.When you deploy the feature, the assembly file is copied to either the system's Global Assembly Cache (GAC)global assembly cache (GAC) or the Bin folder in the SharePoint physical directory. Pour plus d’informations, consultez Comment : Comment : ajouter et supprimer des assemblys supplémentaires.For more information, see how to: How to: Add and remove additional assemblies.

Pour plus d’informations sur les récepteurs, consultez récepteur d’événements de fonctionnalité et événements de fonctionnalité.For more information about feature receivers, see Feature Event Receiver and Feature Events.

Références de sortie de projetProject output references

La propriété de références de sortie de projet spécifie une dépendance, par exemple un assembly, que votre élément de projet doit s’exécuter.The Project Output References property specifies a dependency, such as an assembly, that your project item needs to run. Par exemple, supposons que votre solution contient un projet BDC et un projet de classe.For example, suppose your solution has a BDC project and a class project. Si le projet BDC a une dépendance sur l’assembly qui est générée par le projet de classe, vous pouvez référencer l’assembly dans la propriété de références de sortie de projet du projet BDC.If the BDC project has a dependency on the assembly that is output by the class project, you can reference the assembly in the BDC project's Project Output References property. Lorsque le projet BDC est empaqueté, l’assembly dépendant est inclus dans le package.When the BDC project is packaged, the dependent assembly is included in the package.

Références de sortie de projet sont généralement des assemblys, mais dans certains cas (par exemple, des projets Silverlight) peuvent être des autres types de fichiers.Project output references are usually assemblies, but in some cases (such as Silverlight projects) can be other file types.

Pour plus d’informations, consultez Comment : ajouter une référence de sortie de projet.For more information, see How to: Add a project output reference.

Entrées de contrôle sécuriséSafe control entries

SharePoint fournit un mécanisme de sécurité, les entrées de contrôle sécurisé pour limiter l’accès des utilisateurs non approuvés à certains contrôles.SharePoint provides a security mechanism, called safe control entries, to limit the access of untrusted users to certain controls. Par conception, SharePoint permet à des utilisateurs non approuvés charger et créer des pages ASPX sur le serveur SharePoint.By design, SharePoint allows untrusted users to upload and create ASPX pages on the SharePoint server. Pour empêcher ces utilisateurs d’ajouter du code unsafe aux pages ASPX, SharePoint limite leur accès à contrôles sécurisés.To prevent these users from adding unsafe code to ASPX pages, SharePoint limits their access to safe controls. Contrôles sécurisés sont des contrôles ASPX et composants WebPart désignés comme sécurisés et qui peut être utilisé par n’importe quel utilisateur sur votre site.Safe controls are ASPX controls and Web parts designated as secure and that can be used by any user on your site. Pour plus d’informations, consultez étape 4 : ajouter votre composant WebPart à la liste des contrôles.For more information, see Step 4: Add your Web Part to the Safe Controls List.

Chaque élément de projet SharePoint dans Visual StudioVisual Studio possède une propriété appelée entrées de contrôle sécurisé qui a deux sous-propriétés booléennes : Safe et protégé contre les scripts.Every SharePoint project item in Visual StudioVisual Studio has a property called Safe Control Entries that has two Boolean subproperties: Safe and Safe Against Script. La propriété sécurisé Spécifie si les utilisateurs non approuvés peuvent accéder à un contrôle.The Safe property specifies whether untrusted users can access a control. La propriété protégé contre les scripts spécifie si les utilisateurs non approuvés peuvent afficher et modifier les propriétés d’un contrôle.The Safe Against Script property specifies whether untrusted users can view and change a control's properties.

Entrées de contrôle sécurisé sont référencées sur une base de l’assembly.Safe control entries are referenced on an assembly basis. Vous ajoutez des entrées de contrôle sécurisé à l’assembly d’un projet en les entrant dans l’élément de projet entrées de contrôle sécurisé propriété.You add safe control entries to a project's assembly by entering them in the project item's Safe Control Entries property. Toutefois, vous pouvez également ajouter des entrées de contrôle sécurisé à l’assembly d’un projet via la avancé onglet dans le Concepteur de packages lorsque vous ajoutez un assembly supplémentaire au package.However, you can also add safe control entries to a project's assembly through the Advanced tab in the Package Designer when you add an additional assembly to the package. Pour plus d’informations, consultez Comment : marquer des contrôles comme des contrôles sécurisés ou l’inscription d’un Assembly de composant WebPart en tant que.For more information, see How to: Mark controls as safe controls or Registering a Web Part Assembly as a Safe Control.

Entrées XML pour les contrôles sécurisésXML entries for safe controls

Lorsque vous ajoutez une entrée de contrôle sécurisé à un élément de projet ou à l’assembly du projet, une référence est écrite dans le manifeste du package au format suivant :When you add a safe control entry to a project item or to the project's assembly, a reference is written to the package manifest in the following format:

<Assemblies>  
    <Assembly Location="<assembly name>.dll"     
      DeploymentTarget="<'GlobalAssemblyCache' or 'WebApplication'">>  
        <SafeControls>  
            <SafeControl Assembly="<assembly name>.dll" Namespace=  
              "<SharePoint project name>" Safe="<true/false>"     
                TypeName="<control name>"   
                SafeAgainstScript="<true/false>" />  
        </SafeControls>  
    </Assembly>  
</Assemblies>  

Voir aussiSee also

Package et le déploiement de solutions SharePoint Package and deploying SharePoint solutions
Utiliser des modules pour inclure des fichiers dans la solution Use modules to include files in the solution
Étendre le déploiement et empaquetage de SharePointExtend SharePoint packaging and deployment