Créer un récepteur d'événements

  • Article

Créer des récepteurs d’événements vous permet de répondre quand un utilisateur interagit avec des éléments SharePoint comme des listes ou des éléments de liste. Le code dans un récepteur d’événements peut par exemple être déclenché quand un utilisateur modifie le calendrier ou supprime un nom dans une liste de contacts. En suivant cette rubrique, vous allez découvrir comment ajouter un récepteur d’événements à une instance de liste.

Pour effectuer ces étapes, vous devez avoir installé Visual Studio et les éditions prises en charge de Windows et SharePoint. Étant donné que cet exemple nécessite un projet SharePoint, vous devez également avoir effectué la procédure décrite dans la rubrique Procédure pas à pas : créer une colonne de site, un type de contenu et une liste pour SharePoint.

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

Le projet que vous avez créé dans Procédure pas à pas : créer une colonne de site, un type de contenu et une liste pour SharePoint inclut des colonnes de site personnalisées, une liste personnalisée et un type de contenu. Dans la procédure suivante, vous allez développer ce projet en ajoutant un gestionnaire d’événements simple (un récepteur d’événements) à une instance de liste afin de découvrir comment gérer les événements qui se produisent dans des éléments SharePoint comme les listes.

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éer une colonne de site, un type de contenu et une liste pour SharePoint.

  2. Dans l’Explorateur de solutions, choisissez le nœud du projet SharePoint nommé Clinique.

  3. Dans la barre de menus, choisissez Projet>Ajouter un nouvel élément.

  4. Sous Visual C# ou Visual Basic, développez le nœud SharePoint, puis sélectionnez l’élément 2010.

  5. Dans le volet Modèles, choisissez Récepteur d’événements, nommez-le TestEventReceiver1, puis cliquez sur le bouton OK.

    L’Assistant Personnalisation de SharePoint s’affiche.

  6. Dans la liste Quel type de récepteur d’événements souhaitez-vous ?, choisissez Événements d’élément de liste.

  7. Dans la liste Quel type de récepteur d’événements souhaitez-vous ?, choisissez Patients (Clinique\Patients).

  8. Dans la liste Gérer les événements suivants, cochez la case à côté de l’option Un élément a été ajouté, puis choisissez le bouton Terminer.

    Le fichier de code du nouveau récepteur d’événements contient une méthode unique nommée ItemAdded. À l’étape suivante, vous allez ajouter du code à cette méthode pour que chaque contact soit nommé Scott Brown par défaut.

  9. Remplacez la méthode existante ItemAdded par le code suivant, puis choisissez la touche F5 :

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

    Le code s’exécute et le site SharePoint s’affiche dans le navigateur web.

  10. Dans la barre de lancement rapide, choisissez le lien Patients, puis choisissez le lien Ajouter un élément.

    Le formulaire d’entrée de nouveaux éléments s’ouvre.

  11. Entrez des données dans les champs, puis choisissez le bouton Enregistrer.

    Une fois que vous avez choisi le bouton Enregistrer, la colonne Nom du patient est automatiquement mise à jour avec le nom Scott Brown.

Contenu connexe