SharePoint 2007圖文開(kāi)發(fā)教程(5) 體驗(yàn)Event Handler

2020-07-14 13:15:48

字體：大中小

供稿：網(wǎng)友

Event Handler

Event Handler是SharePoint中與文檔庫(kù)或列表相關(guān)聯(lián)的事件處理程序，當(dāng)我們對(duì)項(xiàng)目進(jìn)行某些操作時(shí)，Event Handler就會(huì)截獲這個(gè)事件，然后相應(yīng)的進(jìn)行操作。功能上比較像數(shù)據(jù)庫(kù)中的觸發(fā)器。比如:刪除某個(gè)文件時(shí)向管理員發(fā)送一個(gè)郵件，添加一個(gè)列表時(shí)進(jìn)行其他操作等等。
和2.0相比，WSS3.0對(duì)Event Handler提供了更強(qiáng)大的支持，如：列表，文檔庫(kù)，內(nèi)容類型。并且支持同步和異步的操作等。

為SharePoint提供一個(gè)Event Handler并不是很費(fèi)力，主要包括：開(kāi)啟Event Handler支持，編寫Event Handler程序，向SharePoint中部署Event Handler。接下來(lái)逐一說(shuō)明一下。

開(kāi)啟Event Handler支持

默認(rèn)情況下是不開(kāi)啟Event Handler支持的，需要我們手動(dòng)開(kāi)啟：進(jìn)入應(yīng)用程序管理---進(jìn)入Web應(yīng)用程序常規(guī)設(shè)置。

開(kāi)啟事件處理程序：

這樣就完成了對(duì)Event Handler開(kāi)啟的支持。

編寫Event Handler程序

SharePoint的Event Handler其實(shí)是一個(gè)類，這個(gè)類主要繼承WSS中的SPWebEventReceiver，SPEmailEventReceiver，SPListEventReceiver，SPItemEventReceiver，IListEventSink等類，并且重寫相應(yīng)的方法來(lái)完成我們的需求。

這里做個(gè)簡(jiǎn)單的例子，當(dāng)我們刪除一個(gè)Items時(shí)，向日志文件中添加一條記錄。

直接看代碼：

C# Code復(fù)制內(nèi)容到剪貼板

using System;
using System.Collections.Generic;
using System.Text;
using System.IO;
using Microsoft.SharePoint;
namespace EventHandlerText
{
public class ItemLogEvent : SPItemEventReceiver
{
/// <summary>
/// 重寫ItemDeleting,向日志文件寫數(shù)據(jù)
/// </summary>
public override void ItemDeleting(SPItemEventProperties properties)
{
string path = @"c:/Log.txt";
string text = "刪除Item" + ":" + DateTime.Now.ToString();
StreamWriter writer = new StreamWriter(path);
writer.Write(text);
writer.Close();
}
}
}

是不是很簡(jiǎn)單，接下來(lái)我們按照為WebPart添加密鑰文件的方法，為我們的Event Handler添加密鑰文件，添加的目的我在部署的時(shí)候再說(shuō)。這樣，簡(jiǎn)單的Event Handler就完成了。

向SharePoint中部署Event Handler

和WebPart有所不同的是，Event Handler的dll需要放到GAC（Global Assembly Cache）中，而不能放在SharePoint網(wǎng)站的bin文件夾中，所以我們生成的dll必須進(jìn)行強(qiáng)簽名，這也就是上面為什么添加密鑰文件的目的。

GAC的系統(tǒng)路徑為：C:/WINDOWS/assembly，直接將生成的Event Handler dll拖入到這個(gè)路徑中即可。

先來(lái)看下SharePoint中的情況：

在我們先前創(chuàng)建的網(wǎng)站中，我創(chuàng)建了一個(gè)文檔庫(kù)的List，并且上傳了一個(gè)word文件，我們的Event Handler就是要添加到這里。

接下來(lái)就是將這個(gè)Event Handler部署到SharePoint中。可以通過(guò)代碼的形式，也可以通過(guò)Feature的形式。這里介紹下代碼的形式。

創(chuàng)建一個(gè)批處理程序（當(dāng)然win程序也可以），添加如下代碼：

C# Code復(fù)制內(nèi)容到剪貼板

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;
namespace RegisterEvent
{
class Program
{
static void Main(string[] args)
{
try
{
SPSite site = new SPSite("http://gao:8000/sites/Brian_Publication/");//指定網(wǎng)站
SPWeb web = site.OpenWeb();
SPList list = web.Lists["文檔庫(kù)"];//指定List
list.EventReceivers.Add(SPEventReceiverType.ItemDeleting, "EventHandlerText, Version=1.0.0.0, Culture=neutral, PublicKeyToken=9d965453379ac249", "EventHandlerText.ItemLogEvent");//添加Event Handler
Console.WriteLine("發(fā)布完成");
Console.ReadLine();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
Console.ReadLine();
}
}
}
}