共用方式為


建立事件接收器

建立事件接收器,即可在使用者與 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 鍵:

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

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

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

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

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

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