清單執行個體事件接收器會回應任何清單定義執行個體中發生的事件。 雖然事件接收器範本未啟用特定清單執行個體的目標,但您可修改範圍設定為清單定義的事件接收器,以回應特定清單執行個體中的事件。
若要以特定清單執行個體為目標,請在事件接收器的 Elements.xml 中,將 ListTemplateId
取代為 ListUrl
,並新增清單執行個體的 URL。
建立清單執行個體事件接收器
下列步驟示範如何修改清單項目事件接收器,只回應自訂公告清單執行個體中發生的事件。
修改事件接收器以回應特定清單執行個體
在瀏覽器中開啟 SharePoint 網站。
在瀏覽窗格中,選擇 [清單] 連結。
在 [所有網站內容] 頁面中,選擇 [建立] 連結。
在 [建立] 對話方塊中選擇 [公告] 類型,並將公告命名為 TestAnnouncements,然後選擇 [建立] 按鈕。
在 Visual Studio 中,建立事件接收器專案。
在 [您要何種類型的事件接收器?] 清單中,選擇 [清單項目事件]。
注意
您也可以選取範圍為清單定義的任何其他事件接收器種類,例如,[清單電子郵件事件] 或 [清單工作流程事件]。
在 [何種項目應該做為事件來源?] 清單中,選擇 [公告]。
在 [處理下列事件] 清單中,選取 [正在加入項目] 核取方塊,然後選擇 [完成] 按鈕。
在 [方案總管] 的 EventReceiver1 底下,開啟 Elements.xml。
事件接收器目前是使用下列程式碼行參考 [公告] 清單定義:
<Receivers ListTemplateId="104">
請將這行變更為以下文字:
<Receivers ListUrl="Lists/TestAnnouncements">
這會指示事件接收器只回應您剛建立的新 TestAnnouncements 公告清單中發生的事件。 您可以變更
ListURL
屬性,以參考 SharePoint 伺服器上的任何清單執行個體。開啟事件接收器的程式碼檔案,並在 ItemAdding 方法中放置中斷點。
選擇 F5 鍵,建置並執行方案。
在 SharePoint 中,選擇巡覽窗格中的 [TestAnnouncements] 連結。
選擇 [加入新公告] 連結。
輸入公告的標題,然後選擇 [儲存] 按鈕。
請注意,當新項目加入至自訂公告清單時會遇到中斷點。
選擇 F5 鍵繼續。
在瀏覽窗格中,選擇 [清單] 連結,然後選擇 [公告] 連結。
加入新公告。
請注意,事件接收器不會在新公告上觸發,因為接收器已設定為只回應自訂公告清單執行個體 (TestAnnouncements) 中的事件。