建立事件接收器

建立事件接收器，即可在使用者與 SharePoint 項目 (例如清單或清單項目) 互動時回應。 例如，當使用者變更行事曆或刪除連絡人清單中的名稱時，可以觸發事件接收器中的程式碼。 依照本主題，您可以了解如何將事件接收器新增至清單執行個體。

若要完成這些步驟，您必須已安裝 Visual Studio 和支援的 Windows 和 SharePoint 版本。 此範例需要 SharePoint 專案，因此您也必須完成逐步解說：建立 SharePoint 的網站資料行、內容類型和清單主題中的程序。

新增事件接收器

您在逐步解說：建立 SharePoint 的網站資料行、內容類型和清單中建立的專案包含自訂網站資料行、自訂清單和內容類型。 在下列程序中，您會將簡單的事件處理常式 (事件接收器) 新增至清單執行個體來展開此專案，以顯示如何處理 SharePoint 項目 (例如清單) 中發生的事件。

將事件接收器新增至清單執行個體

1. 開啟您在逐步解說：建立 SharePoint 的網站資料行、內容類型和清單中建立的專案。

2. 在 [方案總管] 中，選擇 SharePoint 專案節點 (名稱為 Clinic)。

3. 在功能表列中，選擇 [專案]>[加入新項目]。

4. 在 [Visual C#] 或 [Visual Basic] 底下展開 [SharePoint] 節點，然後選擇 [2010] 項目。

5. 在 [範本] 窗格中，選擇 [事件接收器]，將其命名為 TestEventReceiver1，然後選擇 [確定] 按鈕。

   SharePoint 自訂精靈隨即出現。

6. 在 [您要何種類型的事件接收器?] 清單中，選擇 [清單項目事件]。

7. 在 [何種項目應該做為事件來源?] 清單中，選擇 [Patients (Clinic\Patients)]。

8. 在 [處理下列事件] 清單中，選取 [已新增一個項目] 旁邊的核取方塊，然後選擇 [完成] 按鈕。

   新事件接收器的程式碼檔案包含名為 ItemAdded 的單一方法。 在下一個步驟中，您會將程式碼新增至此方法，讓每個連絡人預設都會命名為 Scott Brown。

9. 將現有的 ItemAdded 方法取代為下列程式碼，然後選擇 F5 鍵：

   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
   

   此程式碼會執行，而且 SharePoint 網站會出現在網頁瀏覽器中。

10. 在快速啟動列上，選擇 [Patients] 連結，然後選擇 [新增項目] 連結。

    新項目的輸入表單隨即開啟。

11. 在欄位中輸入資料，然後選擇 [儲存] 按鈕。

    選擇 [儲存] 按鈕之後，[Patient Name] 資料行會自動更新為 Scott Brown 這個名字。

相關內容

• 開發 SharePoint 方案