导航

自定义SharePoint HTTP 404页面

Posted on 2008-04-14 21:55  zhalin  阅读(1765)  评论(0编辑  收藏  举报
在SharePoint网站中我们有系统自带的HTTP404页面,也就是说,如果你请求的页面不存在,则该HTTP404页面就被调用了。
现在假如我们要设定自己的页面那怎么做?像这样一个简单的操作在sharepoint里也并不简单。如果在SharePoint Central Administration中可以对此进行设定是最自然不过的事情,可惜的是当前版本的SharePoint没有这个功能。我们需要告诉SharePoint使用自己的页面,现在看来有两种方法。

第一,写一个console application,在服务器上运行这个程序来告诉SharePoint用自己的页面,代码类似这样:
SPWeb site = this.Web;
System.Uri webApplicationUri = new Uri(site.Url);
SPWebApplication webApplication = SPWebApplication.Lookup(webApplicationUri);
webApplication.FileNotFoundPage = MyPageURL_404;
webApplication.Update();
这个方法因为需要在服务器上运行一段额外的代码,假如你不是服务器管理员的话比较麻烦。

第二,可以把上面的功能做成一个Feature,该Feature可以在Site Action里加一个命令来设置,这样就不需要服务器管理员的介入,只要是网站集管理员就可以了。这种做法的目的是当我们以管理员帐号登录的时候,在site collection administration里出现一个可以让我们设置HTTP404页面的地方。
感谢Tim Dobrinski的文章:http://www.thesug.org/blogs/lsuslinky/Lists/Posts/Post.aspx?List=ee6ea231%2D5770%2D4c2d%2Da99c%2Dc7c6e5fec1a7&ID=5

Feature.xml
<?xml version="1.0" encoding="utf-8" ?>
<Feature
Id="{GUID}"
Title="File Not Found Page Settings"
Description=""
Scope="Site"
xmlns="http://schemas.microsoft.com/sharepoint/">
<ElementManifests>
 <ElementManifest Location="elements.xml" />
</ElementManifests>
</Feature>
Elements.xml
<?xml version="1.0" encoding="utf-8" ?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
<CustomAction
Id="FileNotFoundPage"
GroupId="SiteCollectionAdmin"
Location="Microsoft.SharePoint.SiteSettings"
Sequence="2000"
Title="File Not Found Page"
RequireSiteAdministrator="True"
Description="" >
<UrlAction Url="~site/_layouts/fp/Set404Page.aspx"/>
</CustomAction>
</Elements>
我们还需要一个aspx文件当作这个命令的载体,用来设定自定义404页面。
<%@ Assembly Name="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>
<%@ Page Language="C#" MasterPageFile="_layouts/application.master" Inherits="Microsoft.SharePoint.WebControls.LayoutsPageBase" %>
<%@ Import Namespace="Microsoft.SharePoint" %>
<%@ Import Namespace="Microsoft.SharePoint.Administration" %>
<script runat="server">
protected override void OnLoad(EventArgs e) {
if (Page.IsPostBack)
{
SPWeb site = this.Web;
System.Uri webApplicationUri = new Uri(site.Url);
SPWebApplication webApplication = SPWebApplication.Lookup(webApplicationUri);
webApplication.FileNotFoundPage = PageURL_404.Text;
webApplication.Update();
}
}
</script>
。。。。。。(此处略掉页面html代码)
一个要注意的问题是:我们的自定义404页面必须要放在 /12/TEMPLATE/LAYOUTS/1033目录里面,(1033是英语,如果是别的语言比如说法语则换成1036,etc.)