[SharePoint 2010]如何定制事件处理程序的Error Pages

我想只要是做过MOSS开发工作的人都应该很熟悉EventHandler了吧，通过EventHandler我们可以在某些事件发生的时或发生后执行我们自定义的代码。大家可能都遇到过这种需求，就是在用户创建新的列表项目时可以对用户所输入的内容进行验证，在SharePoint 2007中我们怎么做呢？开发自定义字段类型？好是好，就是太麻烦了，有没有简单一点的方法呢？事件处理程序？这个好，实现起来也简单，我们可以在ItemAdding事件里获得用户输入的内容，然后根据一定的逻辑去判断用户输入内容的有效性，如果未通过就Cancle掉，这个方法是真好，可就是那个验证未通过后抛出的Error页面实在是太难看了，最终用户很少有能接受的，而且还经常被测试人员当BUG给指出来。。。。。。在SharePoint 2007中实在是没有什么好办法来解决这个问题，不过，幸运的是在SharePoint 2010中这个问题终于被解决了。

下面我将向大家介绍在SharePoint 2010中如何定制事件处理程序的Error Pages。

创建一个拥有自定制Error Page的事件处理程序

首先让我们打开VS 2010并且使用事件接受器模板创建一个新的事件处理程序。

我们可以选择是创建一个场解决方案还是沙盒解决方案

最后选择事件接受器的类型，由于我的这个例子是要验证用户的输入内容，所以在这里我选择创建一个ItemAdding类型的事件接受器。

单击完成，随后我们会看到VS 2010自动为我们创建出了如下的结构的项目

接下来要做的就是为我的事件处理程序添加代码，以处理一些简单的逻辑。打开EventReceiver1.cs，VS已经为我们建立好了大部分的内容，我只需添加一些核心的逻辑就可以了。

using System;

using System.Security.Permissions;

using Microsoft.SharePoint;

using Microsoft.SharePoint.Security;

using Microsoft.SharePoint.Utilities;

using Microsoft.SharePoint.Workflow;



namespace ItemAddingWithCustomErrorPage.EventReceiver1

{

    /// <summary>

    /// 列表项事件

    /// </summary>

    public class EventReceiver1 : SPItemEventReceiver

    {

       /// <summary>

       /// 正在添加项.

       /// </summary>

       public override void ItemAdding(SPItemEventProperties properties)

       {

           base.ItemAdding(properties);



           if (properties.AfterProperties["到期日期"]==null)

           {

               properties.Status = SPEventReceiverStatus.CancelWithRedirectUrl;



               properties.RedirectUrl = "/_layouts/ItemAddingWithCustomErrorPage/CustomErrorPage.aspx";

           }

       }



    }

}

下面要做的就是添加一个用于显示错误信息的应用程序页。首先添加一个新项，仍然是在SharePoint 2010模板中，选择应用程序页模板。

Visual Studio 2010会自动创建一个名为Layouts的映射文件夹，它会映射到SharePoint安装目录中的Layouts目录。

下面要做的就是编辑这个应用程序页面，我们可以自由的定制它的样式，以及其中要显示的信息。

<%@ Assembly Name="$SharePoint.Project.AssemblyFullName$" %>

<%@ Import Namespace="Microsoft.SharePoint.ApplicationPages" %>

<%@ Register Tagprefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>

<%@ Register Tagprefix="Utilities" Namespace="Microsoft.SharePoint.Utilities" Assembly="Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>

<%@ Register Tagprefix="asp" Namespace="System.Web.UI" Assembly="System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" %>

<%@ Import Namespace="Microsoft.SharePoint" %>

<%@ Assembly Name="Microsoft.Web.CommandUI, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="CustomErrorPage.aspx.cs" Inherits="ItemAddingWithCustomErrorPage.Layouts.ItemAddingWithCustomErrorPage.CustomErrorPage" DynamicMasterPageFile="~masterurl/default.master" %>



<asp:Content ID="PageHead" ContentPlaceHolderID="PlaceHolderAdditionalPageHead" runat="server">



</asp:Content>



<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">

<div style="width:225px;float:left;">

    <asp:Image ID="Image1" runat="server" ImageUrl="/_layouts/ItemAddingWithCustomErrorPage/saw.png"/>

</div>

<div style="width:400px;">

    [SharePoint 2010]如何定制事件处理程序的Error Pages，希望能有更多的朋友能够加入到SharePoint这个大家园中来。

</div>

</asp:Content>



<asp:Content ID="PageTitle" ContentPlaceHolderID="PlaceHolderPageTitle" runat="server">

这是一个自定义的错误信息页面

</asp:Content>



<asp:Content ID="PageTitleInTitleArea" ContentPlaceHolderID="PlaceHolderPageTitleInTitleArea" runat="server" >

这是一个自定义的错误信息页面

</asp:Content>

OK，到这里代码就全部写完了，让我们来测试一下吧，直接按"F5"就可以了，VS 2010会自动帮我们部署到SharePoint网站中。

让我来新建一条通知。

为了测试我们定制的Error页面，我故意不输入到期日期，这样当触发ItemAdding事件时将判断到期日期字段的值为空，从而Cancle掉这个ItemAdding事件，并跳转到我们所定制的Error Page。

OY，成功了。显然我这个错误信息页面比较简陋，大家在项目中可以将这个Error Page做的尽可能好一些，从而使用户可以很容易的知道自己究竟在哪里出了错。