Partager via

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

  • Article

En créant des récepteurs d'événements, vous pouvez répondre lorsqu'un utilisateur interagit avec des éléments SharePoint tels que des listes ou des éléments de liste.Par exemple, le code dans un récepteur d'événements peut être déclenché lorsqu'un utilisateur modifie le calendrier ou supprime un nom d'une liste de contacts.En suivant cette rubrique, vous pouvez savoir comment ajouter un récepteur d'événements à une instance de liste.

Pour exécuter ces étapes, vous devez avoir installé Visual Studio et en charge des éditions windows et de SharePoint.Pour plus d'informations, consultez Configuration requise pour développer des solutions SharePoint.Comme cet exemple requiert un projet SharePoint, vous devez également avoir terminé la procédure dans la rubrique Procédure pas à pas : création d'une colonne de site, d'un type de contenu et d'une liste pour SharePoint.

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

Le projet que vous avez créé dans Procédure pas à pas : création d'une colonne de site, d'un type de contenu et d'une liste pour SharePoint inclut des colonnes personnalisées de site, une liste personnalisée, et un type de contenu.Dans la procédure suivante, vous développerez ce projet en ajoutant un gestionnaire d'événements simple (un récepteur d'événements) à une instance de liste pour montrer comment gérer des événements qui se produisent dans des éléments SharePoint tels que 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éation d'une colonne de site, d'un type de contenu et d'une liste pour SharePoint.

  2. Dans Explorateur de solutions, sélectionnez le nœud de projet SharePoint, nommé clinique.

  3. Dans la barre de menus, sélectionnez 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 choisissez le bouton OK .

    L'Assistant Personnalisation de SharePoint s'affiche.

  6. Dans la liste Quel type de récepteur d'événements voulez-vous ? , choisissez Liste des événements d'élément.

  7. Dans la liste Quel élément doit être la source d'événement ? , choisissez patients (clinique \Patients).

  8. Dans la liste Gérer les événements suivants , activez la case à cocher en regard 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.Dans l'étape suivante, vous allez ajouter du code à cette méthode de sorte que chaque contact est nommé Scott Brown par défaut.

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

    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);
}

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

  10. Dans la barre de lancement rapide, cliquez sur le lien patients , puis cliquez sur le lien Ajouter un nouvel élément .

    Le formulaire d'entrée pour les nouveaux éléments s'ouvre.

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

    Après avoir choisi le bouton Enregistrer , nom patient de colonne les mises à jour automatiquement au nom Scott Brown.

Voir aussi

Autres ressources

Développement de solutions SharePoint