提升 SharePoint 代码执行权限
关于如何提升 SharePoint 代码执行权限及相关知识介绍的文章我们园子里有很多，
这里给出其中两篇文章的链接，就不再啰嗦了。
http://www.cnblogs.com/llbofchina/archive/2008/05/24/1206393.html
http://www.cnblogs.com/nirvanalst/archive/2008/10/13/1310411.html
由于项目中经常需要提升某些代码的执行权限，每次都需要写类似于下面的代码：
SPSecurity.RunWithElevatedPrivileges(delegate()
{
using (SPSite Site = new SPSite(SiteId))
{
using (SPWeb Web = Site.OpenWeb(WebUrl))
{
...
}
}
});
久而久之，项目中充斥着“相同的”代码，而且看起来也不是很优雅，
就连使用 “EventHandler Explorer”为表单库、列表绑定事件处理程序时，也多出了
诸如于 <>c__DisplayClass1、<>c__DisplayClass2 等自动生成的类。
考虑到其复用性，故对其作如下封装：
Macroresolute.SharePoint.Utility.Privileges
using System;
using Microsoft.SharePoint;
namespace Pturesoft.Utility.Handler
{
/// <summary>
/// 提供了在 SharePoint 站点和网站上提升方法执行权限所需的功能。无法继承此类。
/// </summary>
public static class Privileges
{
#region static Privileges --- 构造函数
static Privileges()
{
//暂无任何实现。
}
#endregion
#region public delegate [void] PrivilegeMethod --- 表示需要提升执行权限的方法
/// <summary>
/// 表示需要提升执行权限的方法。
/// </summary>
/// <param name="oSite">表示一个包括顶级网站和所有子网站的 SharePoint 站点的集合。</param>
/// <param name="oWeb">表示一个 SharePoint 网站。</param>
/// <param name="args">该方法执行时所需的参数。不需要该参数时，请指定为 null。</param>
public delegate void PrivilegeMethod(SPSite oSite, SPWeb oWeb, Object args);
#endregion
#region public static [void] Elevated --- 在当前站点和当前网站上提升方法的执行权限
/// <summary>
/// 在当前站点和当前网站上提升方法的执行权限。
/// </summary>
/// <param name="privilegeMethod">需要提升执行权限的方法。</param>
/// <param name="args">该方法执行时所需的参数。不需要该参数时，请指定为 null。当需要为 SharePoint 事件处理程序提升方法的执行权限时，该参数必须为 SharePoint 事件的 Microsoft.SharePoint.SPItemEventProperties 消息对象。</param>
public static void Elevated(PrivilegeMethod privilegeMethod, Object args)
{
Guid SiteID;
String WebUrl = null;
if (args is SPItemEventProperties) //事件处理程序
{
SPItemEventProperties Properties = args as SPItemEventProperties;
SiteID = Properties.SiteId;
WebUrl = Properties.RelativeWebUrl;
}
else //页面请求
{
SiteID = SPContext.Current.Site.ID;
WebUrl = SPContext.Current.Web.ServerRelativeUrl;
}
SPSecurity.RunWithElevatedPrivileges(delegate()
{
using (SPSite oSite = new SPSite(SiteID))
{
using (SPWeb oWeb = oSite.OpenWeb(WebUrl))
{
privilegeMethod(oSite, oWeb, args);
}
}
});
}
#endregion
#region public static [void] Elevated --- 为 SharePoint 事件处理程序提升执行权限
/// <summary>
/// 为 SharePoint 事件处理程序提升执行权限。
/// </summary>
/// <param name="privilegeMethod">需要提升执行权限的方法。</param>
/// <param name="properties">SharePoint 事件的 Microsoft.SharePoint.SPItemEventProperties 消息对象。</param>
/// <param name="args">该方法执行时所需的参数。不需要该参数时，请指定为 null。</param>
public static void Elevated(PrivilegeMethod privilegeMethod, SPItemEventProperties properties, Object args)
{
SPSecurity.RunWithElevatedPrivileges(delegate()
{
using (SPSite oSite = new SPSite(properties.SiteId))
{
using (SPWeb oWeb = oSite.OpenWeb(properties.RelativeWebUrl))
{
privilegeMethod(oSite, oWeb, args);
}
}
});
}
#endregion
#region public static [void] Elevated --- 在当前站点和指定的网站上提升方法的执行权限
/// <summary>
/// 在当前站点和指定的网站上提升方法的执行权限。
/// </summary>
/// <param name="privilegeMethod">需要提升执行权限的方法。</param>
/// <param name="webUrl">一个字符串，包含相对于服务器或相对于网站的的 URL。相对于服务器的 URL 以正斜杠 ("/")，开始，而相对于网站的 URL 不以正斜杠开头。</param>
/// <param name="args">该方法执行时所需的参数。不需要该参数时，请指定为 null。</param>
public static void Elevated(PrivilegeMethod privilegeMethod, String webUrl, Object args)
{
Guid SiteID = SPContext.Current.Site.ID;
SPSecurity.RunWithElevatedPrivileges(delegate()
{
using (SPSite oSite = new SPSite(SiteID))
{
using (SPWeb oWeb = oSite.OpenWeb(webUrl))
{
privilegeMethod(oSite, oWeb, args);
}
}
});
}
#endregion
#region public static [void] Elevated --- 在指定的站点和指定网站上提升方法的执行权限
/// <summary>
/// 在指定的站点和指定网站上提升方法的执行权限。
/// </summary>
/// <param name="privilegeMethod">需要提升权限的方法。</param>
/// <param name="siteUrl">一个字符串，该字符串指定网站集的绝对 URL。</param>
/// <param name="webUrl">一个字符串，包含相对于服务器或相对于网站的的 URL。相对于服务器的 URL 以正斜杠 ("/")，开始，而相对于网站的 URL 不以正斜杠开头。</param>
/// <param name="args">该方法执行时所需的参数。不需要该参数时，请指定为 null。</param>
public static void Elevated(PrivilegeMethod privilegeMethod, String siteUrl, String webUrl, Object args)
{
SPSecurity.RunWithElevatedPrivileges(delegate()
{
using (SPSite oSite = new SPSite(siteUrl))
{
using (SPWeb oWeb = oSite.OpenWeb(webUrl))
{
privilegeMethod(oSite, oWeb, args);
}
}
});
}
#endregion
}
}
注：均提升到系统权限级别！
封装后，将需要提升执行权限的方法、方法所需参数传递给静态方法 Privileges.Elevated 即可。
需要提升执行权限的方法签名如下：
#region private [void] Testing --- 表示需要提升执行权限的方法
/// <summary>
/// 表示需要提升执行权限的方法。
/// </summary>
/// <param name="oSite">表示一个包括顶级网站和所有子网站的 SharePoint 站点的集合。</param>
/// <param name="oWeb">表示一个 SharePoint 网站。</param>
/// <param name="args">该方法执行时所需的参数。不需要该参数时，请指定为 null。</param>
private void Testing(SPSite oSite, SPWeb oWeb, object args)
{
...
}
#endregion
提升方法的执行权限时，有以下四种可选重载：
//重载一：适用于 InfoPath 表单(浏览器模式)、WebPart、页面请求、SharePoint 事件处理程序(参数必须为事件的 SPItemEventProperties 消息对象)
Privileges.Elevated(this.Testing, null);
//重载二：仅适用于 SharePoint 事件处理程序
Privileges.Elevated(this.Testing, properties, null);
//重载三：适用于 InfoPath 表单(浏览器模式)、WebPart、页面请求
Privileges.Elevated(this.Testing, "webUrl", null);
//重载四：适用于任何情况
Privileges.Elevated(this.Testing, "siteUrl", "webUrl", null);
源文件：https://files.cnblogs.com/zys529/Privileges.rar
MD5：B288FF01FDFBF9E0F82F5B1DEF6E3800
