HOW TO:建立事件接收器
藉由建立 事件接收器,您可以回應的事件,在使用者與 SharePoint 項目互動 (例如清單或清單項目時例如,在中,當使用者變更行事曆或刪除連絡人清單時,的名稱在事件接收器中的程式碼可能會觸發。遵循這個主題中,您可以學習如何將事件接收器加入至清單執行個體。
若要完成這些步驟,您必須已安裝 Visual Studio 和支援 Windows 和 SharePoint 版本。如需詳細資訊,請參閱開發 SharePoint 方案的要求。因為這個範例需要有一個 SharePoint 專案,您也必須完成本主題 逐步解說:建立 SharePoint 的網站資料行、內容類型和清單的程序。
加入事件接收器
您可以在 逐步解說:建立 SharePoint 的網站資料行、內容類型和清單 建立的專案會包含自訂網站欄、自訂清單和一個內容類型。在下列程序中,您可以將簡單的事件處理常式會展開這個專案 (事件接收器) 加入至清單執行個體顯示如何處理在 SharePoint 項目 (如清單時發生的事件。
若要將事件接收器加入至清單執行個體
開啟您在逐步解說:建立 SharePoint 的網站資料行、內容類型和清單中建立的專案。
在 [方案總管],選取 SharePoint 專案節點,其名稱 [診斷所]。
在功能表列上的 [],然後選取 [專案], [加入新項目]。
在 [Visual C#] 或 [Visual Basic] 下,展開 [SharePoint] 節點,然後選取 [2010 年] 項目。
在 [樣板] 窗格中,選取 [事件接收器],並將它命名為 TestEventReceiver1,然後選取 [確定] 按鈕。
[SharePoint 自訂精靈] 隨即出現。
在 [您要何種類型的事件接收器?] 清單中,選取 [清單項目事件]。
在 [何種項目應該做為事件來源?] 清單中,選取 [患者 (診斷) 所\Patients]。
在 [處理下列事件] 清單中,按一下 [已加入一個項目] 旁邊的核取方塊,然後選取 [完成] 按鈕。
新的事件接收器中的程式碼檔案包含名為 ItemAdded的單一方法。在下一個步驟中,您會將程式碼加入至方法,以將每個連絡人會命名為 Scott Brown 介紹預設值。
以下列程式碼取代現有的 ItemAdded 方法,然後選取 F5 鍵:
Public Overrides Sub ItemAdded(ByVal properties As SPItemEventProperties) properties.ListItem("Patient Name") = "Scott Brown" properties.ListItem.Update() MyBase.ItemAdded(properties) End Sub
public override void ItemAdded(SPItemEventProperties properties) { properties.ListItem["Patient Name"] = "Scott Brown"; properties.ListItem.Update(); base.ItemAdded(properties); }
程式碼執行,因此, SharePoint 網站會隨即出現在這個 Web 瀏覽器。
在快速啟動列上,選取 [患者] 連結,然後選取 [加入新項目] 連結。
新項目的表單隨即開啟。
在欄位中輸入資料,然後選取 [儲存] 按鈕。
在 [儲存] 按鈕之後,對名稱 Scott Brown 自動 [Patient Name] 更新的欄位。