Comment : créer un récepteur d’événementsHow to: Create an event receiver

En créant récepteurs d’événements, vous pouvez répondre lorsqu’un utilisateur interagit avec les éléments de SharePoint telles que les listes ou éléments de liste.By creating event receivers, you can respond when a user interacts with SharePoint items such as lists or list items. 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.For example, the code in an event receiver can be triggered when a user changes the calendar or deletes a name from a contacts list. En suivant cette rubrique, vous pouvez apprendre à ajouter un récepteur d’événements à une instance de liste.By following this topic, you can learn how to add an event receiver to a list instance.

Pour effectuer ces étapes, vous devez avoir installé Visual StudioVisual Studio et éditions de Windows et SharePoint prises en charge.To complete these steps, you must have installed Visual StudioVisual Studio and supported editions of Windows and SharePoint. Étant donné que cet exemple requiert un projet SharePoint, vous également devez avoir terminé la procédure décrite dans la rubrique procédure pas à pas : créer une colonne de site, le type de contenu et la liste pour SharePoint.Because this example requires a SharePoint project, you also must have completed the procedure in the topic Walkthrough: Create a site column, content type, and list for SharePoint.

Ajout d’un récepteur d’événementsAdding an event receiver

Le projet que vous avez créé dans procédure pas à pas : créer une colonne de site, le type de contenu et la liste pour SharePoint inclut des colonnes de site personnalisées, une liste personnalisée et un type de contenu.The project that you created in Walkthrough: Create a site column, content type, and list for SharePoint includes custom site columns, a custom list, and a content type. 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 pour montrer comment gérer les événements qui se produisent dans les éléments tels que des listes SharePoint.In the following procedure, you'll expand this project by adding a simple event handler (an event receiver) to a list instance to show how to handle events that occur in SharePoint items such as lists.

Pour ajouter un récepteur d’événements à l’instance de listeTo add an event receiver to the list instance

  1. Ouvrez le projet que vous avez créé dans procédure pas à pas : créer une colonne de site, le type de contenu et la liste pour SharePoint.Open the project that you created in Walkthrough: Create a site column, content type, and list for SharePoint.

  2. Dans l’Explorateur de solutions, choisissez le nœud de projet SharePoint, qui est nommé clinique.In Solution Explorer, choose the SharePoint project node, which is named Clinic.

  3. Dans la barre de menus, choisissez Projet > Ajouter un nouvel élément.On the menu bar, choose Project > Add New Item.

  4. Sous Visual C# ou Visual Basic, développez le SharePoint nœud, puis choisissez le 2010 élément.Under either Visual C# or Visual Basic, expand the SharePoint node, and then choose the 2010 item.

  5. Dans le modèles volet, choisissez récepteur d’événements, nommez-le TestEventReceiver1, puis choisissez le OK bouton.In the Templates pane, choose Event Receiver, name it TestEventReceiver1, and then choose the OK button.

    Le Assistant Personnalisation de SharePoint s’affiche.The SharePoint Customization Wizard appears.

  6. Dans le quel type de récepteur d’événements voulez-vous ? , choisissez événements d’élément de liste.In the What type of event receiver do you want? list, choose List Item Events.

  7. Dans le quel élément doit être la source d’événements ? , choisissez Patients (Clinic\Patients).In the What item should be the event source? list, choose Patients (Clinic\Patients).

  8. Dans le gérer les événements suivants , sélectionnez la case à cocher à côté un élément a été ajouté, puis choisissez le Terminer bouton.In the Handle the following events list, select the check box next to An item was added, and then choose the Finish button.

    Le fichier de code pour le récepteur d’événements contient une méthode unique nommée ItemAdded.The code file for the new event receiver contains a single method that's named ItemAdded. Dans l’étape suivante, vous ajouterez du code à cette méthode afin que chaque contact sera nommé Scott Brown par défaut.In the next step, you'll add code to this method so that every contact will be named Scott Brown by default.

  9. Remplacer la ItemAdded méthode par le code suivant de code, puis choisissez le F5 clé :Replace the existing ItemAdded method with the following code, and then choose the F5 key:

    public override void ItemAdded(SPItemEventProperties properties)
    {
        properties.ListItem["Patient Name"] = "Scott Brown";
        properties.ListItem.Update();
        base.ItemAdded(properties);
    }
    
    Public Overrides Sub ItemAdded(ByVal properties As SPItemEventProperties)
        properties.ListItem("Patient Name") = "Scott Brown"
        properties.ListItem.Update()
        MyBase.ItemAdded(properties)
    End Sub
    

    Le code est exécuté et le site s’affiche dans le navigateur web de SharePoint.The code runs, and the SharePoint site appears in the web browser.

  10. Dans la barre de lancement rapide, choisissez le Patients lier, puis choisissez le ajouter un nouvel élément lien.On the QuickLaunch bar, choose the Patients link, and then choose the Add New Item link.

    Le formulaire d’entrée pour les nouveaux éléments s’ouvre.The entry form for new items opens.

  11. Entrez des données dans les champs, puis choisissez le enregistrer bouton.Enter data in the fields, and then choose the Save button.

    Après avoir choisi le enregistrer bouton, le nom du Patient colonne met automatiquement à jour le nom Scott Brown.After you choose the Save button, the Patient Name column automatically updates to the name Scott Brown.

Voir aussiSee also