Partager via

Comment : créer un récepteur d'événements

  • Article

Les récepteurs d'événements sont des classes permettant de répondre aux événements liés aux éléments SharePoint, tels que les listes ou les éléments de liste. La modification d'une entrée du calendrier ou la suppression d'un nom dans la liste de contacts ont pour effet de déclencher le code à l'intérieur du récepteur d'événements.

Cette procédure illustre les tâches suivantes :

  • Ajout d'un récepteur d'événements à une instance de liste.

Vous avez besoin des composants suivants pour effectuer ces étapes :

Vous devez également réaliser la procédure décrite à la rubrique Procédure pas à pas : création d'un champ personnalisé, d'un type de contenu, d'une définition de liste et d'une instance de liste.

Ajout d'un récepteur d'événements

Le projet que vous avez créé dans Procédure pas à pas : création d'un champ personnalisé, d'un type de contenu, d'une définition de liste et d'une instance de liste inclut un champ personnalisé, une définition de liste personnalisée avec une instance de cette liste, et un type de contenu. Vous allez maintenant ajouter un récepteur d'événements à ce projet. La procédure suivante permet d'ajouter un simple gestionnaire d'événements (récepteur d'événements) à l'instance de liste.

Pour ajouter un récepteur d'événements à l'instance de liste

  1. Ouvrez le projet que vous avez créé dans Procédure pas à pas : création d'un champ personnalisé, d'un type de contenu, d'une définition de liste et d'une instance de liste.

  2. Ajoutez un récepteur d'événements à ce projet. Pour ce faire, cliquez sur le nœud de projet dans l'Explorateur de solutions, puis choisissez Ajouter un nouvel élément dans le menu Projet.

  3. Développez le nœud SharePoint sous Visual C# ou Visual Basic, puis cliquez sur 2010.

  4. Dans le volet Modèles, sélectionnez Récepteur d'événements et nommez-le TestEventReceiver1.

    L'Assistant Personnalisation de SharePoint s'affiche.

  5. Dans la page Choisir les paramètres de récepteur d'événements, sélectionnez Liste des événements d'élément comme type de récepteur d'événements.

  6. Affectez à l'élément Source de l'élément la valeur CustomField1 - ListDefinition1.

  7. Dans la liste des événements à gérer, activez la case à cocher en regard de l'option Un élément a été ajouté, puis cliquez sur Terminer.

  8. Le nouveau fichier de code de récepteur d'événements contient une méthode unique nommée ItemAdded. Ajoutez du code à cette méthode de façon à utiliser la valeur par défaut Michel Lebrun (pour Nom du patient) chaque fois qu'un contact est ajouté à la liste de contacts. Pour ce faire, remplacez la méthode ItemAdded existante par ce qui suit :

    Public Overrides Sub ItemAdded(ByVal properties As SPItemEventProperties)
    properties.ListItem("Patient Name") = "Scott Brown"
    properties.ListItem.Update()
    MyBase.ItemAdded(properties)
End Sub

    public override void ItemAdded(SPItemEventProperties properties)
{
    properties.ListItem["Patient Name"] = "Scott Brown";
    properties.ListItem.Update();
    base.ItemAdded(properties);
}

  9. Appuyez sur F5 pour exécuter le code et consulter le site SharePoint dans le navigateur Web.

  10. Dans la barre de lancement rapide, cliquez sur CustomField1 - ListInstance1.

    Il s'agit de l'instance de liste pour la définition de liste. Notez que le champ Nom du patient n'est pas encore présenté sous forme de colonne dans l'instance de liste.

  11. Cliquez sur Liste dans l'onglet Outils de liste en haut de la page, puis cliquez sur le bouton Modifier cet affichage sur le ruban.

  12. Dans la liste des noms de colonnes disponibles, sélectionnez Nom du patient, puis cliquez sur OK. Remarquez que le champ Nom du patient figure, à présent, dans l'instance de liste.

  13. Sous l'onglet Outils de liste en haut de la page, cliquez sur Éléments, puis sur le bouton Nouvel élément pour afficher le formulaire d'entrée des données.

  14. Saisissez les données dans les champs, puis cliquez sur le bouton Enregistrer dans la boîte de dialogue du nouvel élément de l'instance de liste.

    Michel Lebrun apparaît automatiquement dans la colonne Nom du patient dès que vous cliquez sur OK.

Voir aussi

Autres ressources

Développement de solutions SharePoint