Définition de types d'éléments de projet SharePoint personnalisés

Article
08/10/2011

Définissez un type d'élément de projet SharePoint si vous voulez créer un nouveau genre d'élément de projet SharePoint. Par exemple, Visual Studio 2010 n'inclut pas d'éléments de projet SharePoint pour l'ajout de champs ou d'actions personnalisées à un Site SharePoint. Vous pouvez définir vos propres types d'éléments de projet SharePoint pour la création de champs, d'actions personnalisées ou d'autres types de composants SharePoint.

Tâches permettant de définir des types d'éléments de projet SharePoint

Pour définir un type d'élément de projet personnalisé, générez un assembly d'extension Visual Studio qui implémente l'interface ISharePointProjectItemTypeProvider. Pour plus d'informations, consultez Comment : définir un type d'élément de projet SharePoint.

Lorsque vous définissez un type d'élément de projet personnalisé, vous pouvez également ajouter les fonctionnalités suivantes à l'élément de projet :

Ajout d'un élément de menu contextuel à l'élément de projet. L'élément de menu apparaît lorsque vous cliquez avec le bouton droit sur l'élément de projet dans l'Explorateur de solutions. Pour plus d'informations, consultez Comment : ajouter un élément de menu contextuel à un type d'élément de projet SharePoint personnalisé.
Ajout d'une propriété personnalisée à l'élément de projet. La propriété apparaît dans la fenêtre Propriétés lorsque vous sélectionnez l'élément de projet dans l'Explorateur de solutions. Pour plus d'informations, consultez Comment : ajouter une propriété à un type d'élément de projet SharePoint personnalisé.

Pour permettre à d'autres développeurs d'utiliser votre élément de projet dans Visual Studio, créez un fichier .spdata et un modèle d'élément ou de projet associé à l'élément de projet. Pour plus d'informations, consultez Création de modèles d'élément et de modèles de projet pour les éléments de projet SharePoint.

Fonctionnement de la relation entre les types et les instances d'éléments de projet

Lorsque vous définissez un type d'élément de projet SharePoint, Visual Studio charge votre extension au moment où un élément de projet du type associé est ajouté à un projet SharePoint. Par exemple, si vous définissez un nouveau type d'élément de projet Action personnalisée, Visual Studio charge votre extension lorsqu'un utilisateur ajoute un élément de projet Action personnalisée à un projet. Visual Studio utilise la même instance de votre extension pour toutes les instances du type d'élément de projet associé. Dans l'exemple précédent, si l'utilisateur ajoute un deuxième élément de projet Action personnalisée au projet, la même instance de votre extension est employée pour personnaliser le deuxième élément de projet.

Pour accéder à une instance spécifique de votre type d'élément de projet, gérez l'un des événements ISharePointProjectItemEvents du paramètre projectItemTypeDefinition dans votre implémentation de la méthode ISharePointProjectItemTypeProvider.InitializeType. Par exemple, pour déterminer quand un élément de projet de votre type personnalisé est ajouté à un projet, gérez l'événement ProjectItemAdded. Pour plus d'informations, consultez Comment : définir un type d'élément de projet SharePoint.