SharePoint 2007图文开发教程(5) 体验Event Handler

什么是Event Handler？

Event Handler是指一种事件处理程序，常用于在数据更新、插入或删除等操作的过程中执行特定的操作，例如发送邮件通知、记录日志等。在SharePoint中，Event Handler被广泛应用于对列表、文档库等对象的事件进行处理。

如何创建Event Handler？

在SharePoint 2007中，可以通过Visual Studio创建Event Handler。具体步骤如下：

1. 打开Visual Studio。
2. 选择“File” > “New” > “Project”。
3. 在“New Project”对话框中，选择“SharePoint” > “Sequential Workflow”。
4. 在“Name”和“Location”中填写相关信息，点击“OK”。
5. 在“SharePoint Customization Wizard”中，选择“Event Receiver”。
6. 设置Event Handler的属性，例如绑定的列表、事件类型等。

Event Handler示例1：发送邮件通知

一般情况下，我们希望在数据更新后，能够以邮件的形式通知相关人员。此时，可以通过Event Handler处理数据更新事件，触发邮件发送操作。具体示例代码如下：

public override void ItemUpdated(SPItemEventProperties properties)
{
    base.ItemUpdated(properties);
    SendEmail(properties.ListItem);
}

private void SendEmail(SPListItem item)
{
    // 获取收件人、发件人、主题、内容等信息
    string to = GetEmailAddresses(item["To"]);
    string from = GetEmailAddress(item["From"]);
    string subject = item["Subject"].ToString();
    string body = item["Body"].ToString();

    // 创建MailMessage对象
    MailMessage message = new MailMessage(from, to, subject, body);

    // 发送邮件
    SmtpClient client = new SmtpClient();
    client.Send(message);
}

在上述代码中，ItemUpdated方法被重写，当列表项更新时，会调用该方法。方法中调用了一个名为“SendEmail”的方法，该方法会以邮件形式发送信息，其中包括：收件人、发件人、主题、内容等信息。

Event Handler示例2：记录日志

有时候，我们需要对某些操作进行记录，以便跟踪操作历史及排查问题。此时，可以通过Event Handler记录日志信息。具体示例代码如下：

public override void ItemDeleting(SPItemEventProperties properties)
{
    base.ItemDeleting(properties);
    WriteLog(properties.ListTitle, properties.ListItemId, "删除");
}

private void WriteLog(string listTitle, int itemId, string action)
{
    // 获取当前站点的SPWeb对象
    SPWeb web = properties.Web;

    // 获取日志列表
    SPList logList = web.Lists["日志"];

    // 创建日志项
    SPListItem logItem = logList.Items.Add();
    logItem["列表"] = listTitle;
    logItem["列表项ID"] = itemId;
    logItem["操作"] = action;
    logItem.Update();
}

在上述代码中，ItemDeleting方法被重写，当列表项被删除时，会调用该方法。方法中调用了一个名为“WriteLog”的方法，该方法会将操作历史记录在名为“日志”的列表中。

总结

通过本文，我们了解了Event Handler的概念，并以发送邮件和记录日志两个示例，介绍了如何创建、使用Event Handler。在实际开发中，Event Handler可以为我们提供很多便利，例如自动化处理、信息通知、日志记录等，能够大大提高开发效率和系统可靠性。