WSS 3.0 SDK 實戰演練：建立事件接收器 Feature——攔截列表項刪除操作的完整實作

演練目標

建立一個 **ItemDeleting** 事件接收器，攔截並取消特定列表（公告列表）的項目刪除操作，以 Feature 形式部署啟用。

兩階段實作流程

1. Visual Studio 建立事件接收器組件（Class Library）。
2. 封裝為 Feature 部署至 WSS。

階段一：Visual Studio 建立事件處理程序

1. 新專案：Visual C# → Class Library，名稱 DeletingEventHandler。
2. 加入參考：Microsoft.SharePoint (.NET 標籤)。
3. 引用命名空間：using Microsoft.SharePoint;
4. 類別繼承 SPItemEventReceiver，覆寫 ItemDeleting：

   public class DeletingAction : SPItemEventReceiver
   {
       public override void ItemDeleting(SPItemEventProperties properties)
       {
           properties.Cancel = true; // 取消刪除
           properties.ErrorMessage = "Deleting items from " + properties.RelativeWebUrl + " is not supported.";
       }
   }

5. 專案屬性 → 簽署 → 勾選「簽署組件」→ 新建強名稱金鑰 DeletingEventHandler.snk。
6. Ctrl+Shift+B 編譯產生 DLL。
7. 將 DeletingEventHandler.dll 從 bin\Debug 拖曳至 C:\Windows\Assembly 部署 GAC。

階段二：封裝為 Feature 部署

1. 建立 Feature 目錄：.../12/TEMPLATE/FEATURES/DeletingEventHandler
2. 建立 Feature.xml（範圍 Web）：

   <Feature Scope="Web" Title="Deleting Event Handler" Id="{GUID}"
     xmlns="https://schemas.microsoft.com/sharepoint/">
     <ElementManifests>
       <ElementManifest Location="Elements.xml" />
     </ElementManifests>
   </Feature>

   guidgen.exe 產生 GUID。
3. 建立 Elements.xml 註冊事件接收器：

   <Elements xmlns="https://schemas.microsoft.com/sharepoint/">
     <Receivers ListTemplateId="104"> <!-- 僅套用至公告列表 (Template 104) -->
       <Receiver>
         <Name>DeletingEventHandler</Name>
         <Type>ItemDeleting</Type> <!-- 同步前置事件 -->
         <SequenceNumber>10000</SequenceNumber>
         <Assembly>
           DeletingEventHandler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=a26b5449ac4a4cf3
         </Assembly>
         <Class>DeletingEventHandler.DeletingAction</Class>
         <Data></Data>
         <Filter></Filter>
       </Receiver>
     </Receivers>
   </Elements>

   PublicKeyToken 取得方式：總管瀏覽 C:\Windows\Assembly，右鍵 DLL → 內容 → 一般頁籤複製 Token。
4. 命令列安裝啟用：

   stsadm -o installfeature -filename DeletingEventHandler\feature.xml
   stsadm -o activatefeature -filename DeletingEventHandler\feature.xml -url https://Server/Site/Subsite
   iisreset

驗證與觀察

• 瀏覽該子站台下的任一公告列表，嘗試刪除項目。
• 操作將被取消，頁面顯示錯誤訊息：Deleting items from /sites/subsite is not supported.
• 其他列表類型（工作、連結等）不受影響，因 ListTemplateId="104" 限定範圍。

關鍵技術點總結

此演練展示了從程式碼到 Feature 封裝的事件接收器開發完整鏈路，為 SharePoint 伺服器端邏輯擴充提供標準範本。

1. 上一篇文章： WSS 3.0 SDK 實戰指南：在站台集使用者介面新增自訂動作——Feature 部署 CustomAction 完整演練
2. 下一篇文章： SharePoint WSS 3.0：透過 Feature 建立自訂清單定義完整教學

關於.NET

Log4net 實戰入門（三）：WCF 服務完整整合與部署指南

解決方案結構 Log4netWCFServiceLib

.NET 元資料與 IL 指令集入門：從 HelloWorld 看清單、定義表與常用操作碼

元資料 是描述「資料的資料」，在 CLR 中以三張核心表組織

Entity Framework 核心教程：DbContext 核心功能、生命週期與最佳實踐全解析

什麼是 DbContext？ DbContext 是 Ent

Visual Studio 2010 無法連線 ASP.NET Development Server 解決方案

Visual Studio 2010 無法連線 ASP.NE