在 Visual Studio 中建立簡單的 SharePoint 事件接收器

事件接收器是為 SharePoint 解決方案添加觸發邏輯的有效方式，能讓您在列表項目新增、更新或刪除時自動執行自訂代碼。本文將逐步示範如何使用 Visual Studio 建立一個基本的事件接收器專案。

建立步驟

1. 在 SharePoint 站點上建立一個名為 TestList 的自訂列表，作為事件接收器的監聽目標。
2. 以系統管理員身分啟動 Visual Studio，選擇 建立新專案，搜尋並選取 Event Receiver 專案範本。
3. 將專案命名為 SimpleEventReceiver，部署類型選擇 場方案，然後按 下一步。
4. 在事件接收器設定精靈中：
   • 事件類型選擇 列表項目事件
   • 事件來源選擇 通知 列表
   • 勾選 正在新增項目 事件

後續開發

完成精靈後，Visual Studio 會產生一個繼承自 SPItemEventReceiver 的類別。您可以在 ItemAdding 方法中撰寫自訂邏輯，例如驗證欄位資料、發送通知或更新其他列表。記得在部署前於 Elements.xml 中確認 Receivers 區段的 ListTemplateId 與目標列表類型相符。

部署與測試

建置專案並部署解決方案後，前往 SharePoint 站點的 TestList 新增一個項目，即可觸發事件接收器執行您撰寫的代碼。透過 輸出視窗 或 ULS 日誌 即可除錯驗證。