Extension d'éléments de projet SharePoint
Créez une extension d'élément de projet si vous avez l'intention d'ajouter des fonctionnalités à un type d'élément de projet SharePoint déjà installé dans Visual Studio. Par exemple, vous pouvez créer une extension pour les éléments de projet Récepteur d'événements ou Définition de liste intégrés dans Visual Studio, ou pour un type d'élément de projet personnalisé. Vous avez également la possibilité de créer une extension pour tous les types d'éléments de projet SharePoint.
Tâches permettant d'étendre les éléments de projet SharePoint
Pour étendre un élément de projet, générez un assembly d'extension Visual Studio qui implémente l'interface ISharePointProjectItemTypeExtension. Pour plus d'informations, consultez Comment : créer une extension d'élément de projet SharePoint.
Lorsque vous étendez un élément de projet, 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 à une extension d'élément de projet SharePoint.
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é à une extension d'élément de projet SharePoint.
Pour apprendre à créer, déployer et tester une extension d'élément de projet, étape par étape, consultez Procédure pas à pas : extension d'un type d'élément de projet SharePoint.
Fonctionnement de la relation entre les extensions et les instances d'éléments de projet
Lorsque vous créez une extension d'élément de projet, 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 créez une extension pour les éléments de projet Récepteur d'événements, Visual Studio charge votre extension lorsqu'un utilisateur ajoute un élément de projet Récepteur d'événements à 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 Récepteur d'événements 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 du type d'élément de projet que vous étendez, gérez l'un des événements ISharePointProjectItemEvents du paramètre projectItemType dans votre implémentation de la méthode ISharePointProjectItemTypeExtension.Initialize. Par exemple, pour déterminer quand un élément de projet du type que vous étendez est ajouté à un projet, gérez l'événement ProjectItemAdded. Pour plus d'informations, consultez Comment : créer une extension d'élément de projet SharePoint.
Identificateurs pour les éléments de projet SharePoint
Chaque élément de projet SharePoint est défini par un identificateur de chaîne. Vous devez impérativement connaître l'identificateur d'un élément de projet pour effectuer les tâches suivantes :
Créer une extension pour l'élément de projet. Dans ce cas, vous devez passer l'identificateur de l'élément de projet que vous voulez étendre au constructeur de SharePointProjectItemTypeAttribute. Pour créer une extension pour tous les types d'éléments de projet, passez la valeur de chaîne *.
Ajouter un élément de projet à un projet par programmation. Dans ce cas, vous devez communiquer l'identificateur de l'élément de projet à la méthode ISharePointProjectItemCollection.Add.
Le tableau suivant répertorie les identificateurs des éléments de projet SharePoint inclus avec Visual Studio 2010.
Nom d'élément de projet |
Identificateur de chaîne |
|---|---|
Modèle de catalogue de données métiers |
Microsoft.VisualStudio.SharePoint.BusinessDataConnectivity |
Content-Type |
Microsoft.VisualStudio.SharePoint.ContentType |
Récepteur d'événements |
Microsoft.VisualStudio.SharePoint.EventHandler |
Élément vide |
Microsoft.VisualStudio.SharePoint.GenericElement |
Définition de liste Definition de liste du type de contenu |
Microsoft.VisualStudio.SharePoint.ListDefinition |
Instance de liste |
Microsoft.VisualStudio.SharePoint.ListInstance |
Module |
Microsoft.VisualStudio.SharePoint.Module |
Workflow séquentiel Flux de travail de la machine à états |
Microsoft.VisualStudio.SharePoint.Workflow |
Définition de site |
Microsoft.VisualStudio.SharePoint.SiteDefinition |
Composant Visual Web Part |
Microsoft.VisualStudio.SharePoint.VisualWebPart |
Composant Web Part |
Microsoft.VisualStudio.SharePoint.WebPart |
Formulaire d'association de flux de travail |
Microsoft.VisualStudio.SharePoint.WorkflowAssociation |
Voir aussi
Tâches
Comment : créer une extension d'élément de projet SharePoint
Procédure pas à pas : extension d'un type d'élément de projet SharePoint
Concepts
Extension du système de projet SharePoint
Autres ressources
Comment : ajouter un élément de menu contextuel à une extension d'élément de projet SharePoint
Comment : ajouter une propriété à une extension d'élément de projet SharePoint