Erstellen eines Ereignisempfängers

Durch das Erstellen von Ereignisempfängern können Sie reagieren, wenn ein Benutzer mit SharePoint-Elementen wie Listen oder Listenelementen interagiert. Beispielsweise kann der Code in einem Ereignisempfänger ausgelöst werden, wenn ein Benutzer den Kalender ändert oder einen Namen aus einer Kontaktliste löscht. In diesem Thema erfahren Sie, wie Sie einer Listeninstanz einen Ereignisempfänger hinzufügen.

Um diese Schritte ausführen zu können, müssen Sie Visual Studio und die unterstützten Editionen von Windows und SharePoint installiert haben. Da in diesem Beispiel ein SharePoint-Projekt erforderlich ist, müssen Sie auch das Verfahren im Thema Exemplarische Vorgehensweise: Erstellen einer Websitespalte, eines Inhaltstyps und einer Liste für SharePoint abgeschlossen haben.

Hinzufügen eines Ereignisempfängers

Das Projekt, das Sie im Rahmen von Exemplarische Vorgehensweise: Erstellen einer Websitespalte, eines Inhaltstyps und einer Liste für SharePoint erstellt haben, umfasst benutzerdefinierte Websitespalten, eine benutzerdefinierte Liste und einen Inhaltstyp. Im folgenden Verfahren erweitern Sie dieses Projekt, indem Sie einer Listeninstanz einen einfachen Ereignishandler (einen Ereignisempfänger) hinzufügen, um zu zeigen, wie Ereignisse verarbeitet werden, die in SharePoint-Elementen wie Listen auftreten.

So fügen Sie der Listeninstanz einen Ereignisempfänger hinzu

1. Öffnen Sie das Projekt, das Sie im Rahmen von Exemplarische Vorgehensweise: Erstellen einer Websitespalte, eines Inhaltstyps und einer Liste für SharePoint erstellt haben.

2. Wählen Sie im Projektmappen-Explorer den SharePoint-Projektknoten namens Clinic aus.

3. Wählen Sie in der Menüleiste Projekt>Neues Element hinzufügen aus.

4. Erweitern Sie unter Visual C# oder Visual Basic den Knoten SharePoint, und wählen Sie dann das Element 2010 aus.

5. Wählen Sie im Bereich Vorlagen die Option Ereignisempfänger aus, nennen Sie ihn TestEventReceiver1, und wählen Sie dann die Schaltfläche OK aus.

   Der Assistent zum Anpassen von SharePoint wird angezeigt.

6. Wählen Sie in der Liste Welchen Typ soll der Ereignisempfänger aufweisen? die Option Listenelementereignisse aus.

7. Wählen Sie in der Liste Welches Element soll als Ereignisquelle dienen? die Option Patients (Clinic\Patients) aus.

8. Aktivieren Sie in der Liste Die folgenden Ereignisse behandeln das Kontrollkästchen neben Ein Element wurde hinzugefügt, und wählen Sie dann die Schaltfläche Fertig stellen aus.

   Die Codedatei für den neuen Ereignisempfänger enthält eine einzelne Methode namens ItemAdded. Im nächsten Schritt fügen Sie dieser Methode Code hinzu, sodass jeder Kontakt standardmäßig „Scott Brown“ heißt.

9. Ersetzen Sie die vorhandene ItemAdded-Methode durch den folgenden Code, und drücken Sie dann die F5-TASTE:

   C#

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

   VB

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

   Der Code wird ausgeführt, und die SharePoint-Website wird im Webbrowser angezeigt.

10. Wählen Sie in der Schnellstartleiste den Link Patients und dann den Link Neues Element hinzufügen aus.

    Das Eingabeformular für neue Elemente wird geöffnet.

11. Geben Sie Daten in die Felder ein, und wählen Sie dann die Schaltfläche Speichern aus.

    Nachdem Sie die Schaltfläche Speichern ausgewählt haben, wird die Spalte Patient Name automatisch auf den Namen „Scott Brown“ aktualisiert.

Zugehöriger Inhalt

• Entwickeln von SharePoint-Lösungen