在WSS3.0内创建并使用Event Handler

本文是Ted Pattison的“Creating and Using Event Handler in Windows SharePoint Service 3.0”视频的一个记录和学习。
1. 首先创建一个名为“Orders“的列表，将其“Title”改为“OrderID”，并将其改为不需要一定输入。同时增加以下三个列：
   （1）名称：Customer 类型：Single line of text
   （2）名称：OrderDate 类型：Date and time
   （3）名称：Amount 类型：Currency


2. 建立一个名为LitwareHandlers的Windows Class Library的C#工程。将Class的名字改为OrderHandler。在References中加入Microsoft.SharePoint.dll。


3. 将OrderHandler继承自“SPItemEventReceiver”， 并重载ItemAdded和ItemUpdated。最后追加一个函数GenerateID。代码参照如下：

LitwareHandlers
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Microsoft.SharePoint;

namespace LitwareHandlers
{
    public class OrderHandler : SPItemEventReceiver
    {
        public override void ItemAdded(SPItemEventProperties properties)
        {
            GenerateID(properties);
        }

        public override void ItemUpdated(SPItemEventProperties properties)
        {
            GenerateID(properties);
        }

        void GenerateID(SPItemEventProperties properties)
        {
            SPListItem order = properties.ListItem;
            string customer = order["Customer"].ToString();
            string orderdate = Convert.ToDateTime(order["OrderDate"].ToString()).ToShortDateString();
            order["OrderID"] = customer + " " + orderdate;
            order.Update();
        }
    }
}

4. 将该程序变为使用强名，编译程序。
5. 编译成功后，将LitwareHandlers.dll加入到程序集中。
      gacutil -i LitwareHandlers.dll
6. 向工程集中添加一个新的Consol Application工程，名为HandlerRegistrationApp。在References中加入Microsoft.SharePoint.dll。该工程是为了向Orders列表中注册前面生成的EventHandler。


7. 编辑Program.cs如下所示：

Program.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Microsoft.SharePoint;

namespace HandlerRegistrationApp
{
    class Program
    {
        static void Main(string[] args)
        {
            SPSite collection = new SPSite("http://localhost:40000/Customize");
            SPWeb site = collection.OpenWeb();
            SPList orders = site.Lists["Orders"];

            string asmName = "LitwareHandlers, Version=1.0.0.0, Culture=neutral, PublicKeyToken=538e86bea3aaf975";
            string className = "LitwareHandlers.OrderHandler";

            orders.EventReceivers.Add(SPEventReceiverType.ItemAdded, asmName, className);
            orders.EventReceivers.Add(SPEventReceiverType.ItemUpdated, asmName, className);
        }
    }
}

注意：网站的地址和Dll的PublicKeyToken，根据自己的实际情况而定。
PublicKeyToken的取得方法如下：
      gactuil -l Dll文件名
8. 编译HandlerRegistrationApp，成功后执行。
9. 回到创建的Orders列表，向内添加新的内容，或修改内容，但不要填写OrderID的内容，可以发现会自动生成OrderID的内容。