本文讲述如何在 在SharePoint 2013/2010 解决方案中添加 ashx (HttpHandler)。
一般处理程序(HttpHandler)是·NET众多web组件的一种,ashx是其扩展名。一个httpHandler接受并处理一个http请求,类比于Java中的servlet。类比于在Java中需要继承HttpServlet类,在.net中需要实现IHttpHandler接口,这个接口有一个IsReusable成员,一个待实现的方法ProcessRequest(HttpContextctx) 。程序在processRequest方法中处理接受到的Http请求。成员IsReusable指定此IhttpHnadler的实例是否可以被用来处理多个请求。
.ashx程序适合产生供浏览器处理的、不需要回发处理的数据格式,例如用于生成动态图片、动态文本等内容。
下面笔者将介绍如何在SharePoint 2013/2010 解决方案中添加 ashx (HttpHandler):
1. 新建一个场解决方案
2. 映射 SharePoint 的Layout文件夹
3. 添加新项目
4. 选择Application page
5. 将Test.ashx的代码修改为
SharePoint 2013 ( 注意替换class name )
<%@ Assembly Name="$SharePoint.Project.AssemblyFullName$" %> <%@ Assembly Name="Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> <%@ WebHandler Language="C#" class="Testashx.Test" %>
SharePoint 2010( 注意替换class name ):
<%@ Assembly Name="$SharePoint.Project.AssemblyFullName$" %> <%@ Assembly Name="Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> <%@ WebHandler Language="C#" class="Testashx.Test" %>
6. Test.ashx.cs 代码
using System; using Microsoft.SharePoint; using Microsoft.SharePoint.WebControls; using System.Web; namespace Testashx { public partial class Test : IHttpHandler { public bool IsReusable { get { return true; } } public void ProcessRequest(HttpContext context) { System.Web.Script.Serialization.JavaScriptSerializer jsonSerializer = new System.Web.Script.Serialization.JavaScriptSerializer(); context.Response.ContentType = "application/json"; var jsonResult = jsonSerializer.Serialize(new JosnResult (){Name="Abraham Cheng", Age= 29 });// return what you want context.Response.Write(jsonResult); } } class JosnResult { public string Name {get; set;} public int Age {get; set;} } }
7. UnLoad 项目,编辑项目工程文件,在PropertyGroup节点中插入:
<TokenReplacementFileExtensions>ashx</TokenReplacementFileExtensions>
8. Reload项目, 部署解决方案
9. 验证
a. SharePoint 2013 验证地址为 .../_layouts/15/xxx/Text.ashx
b. SharePoint 2010 验证地址为 .../_layouts/xxx/Text.ashx
打开以上地址就可以返回一个Json对象了
在实际应用可以用Ajax来请求Text.ashx来获取数据,展现在前台,达到不用刷新页面更新数据的目的。