AccessControlHelper
Intro#
由于项目需要，需要在 基于 Asp.net mvc 的 Web 项目框架中做权限的控制，于是才有了这个权限控制组件。
项目基于 .NETStandard，同时支持 asp.net mvc（.NET faremwork4.5以上） 和 asp.net core 项目（asp.net 2.0以上），基于 ASP.NET MVC 和 ASP.NET Core 实现的对 Action 的访问控制以及页面元素的权限控制。
GetStarted#
Nuget Package https://www.nuget.org/packages/WeihanLi.AspNetMvc.AccessControlHelper/
安装权限控制组件
WeihanLi.AspNetMvc.AccessControlHelperasp.net:
Install-Package WeihanLi.AspNetMvc.AccessControlHelperasp.net core:
dotnet add package WeihanLi.AspNetMvc.AccessControlHelper实现自己的权限控制显示策略类
示例代码：
ASP.NET Mvc
ASP.NET Core
实现页面元素显示策略接口
IControlAccessStrategy实现
Action访问显示策略接口IActionAccessStrategy
程序启动时注册自己的显示策略
可基于Autofac实现的依赖注入，在 autofac 的 Ioc Container中注册显示策略，并返回一个可以从Ioc Container中获取对象的委托或者实现 IServiceProvider 接口的对象，参考：https://github.com/WeihanLi/AccessControlHelper/blob/master/samples/PowerControlDemo/Global.asax.cs#L23
//autofac ContainerBuilder
var builder = new ContainerBuilder();
// etc...
// register accesss control
builder.RegisterType<ActionAccessStrategy>().As<IActionAccessStrategy>();
builder.RegisterType<ControlAccessStrategy>().As<IControlAccessStrategy>();
var container = builder.Build();
// Important
AccessControlHelper.RegisterAccessControlHelper<ActionAccessStrategy, ControlAccessStrategy>(type => container.Resolve(type));
在 Startup 文件中注册显示策略，参考https://github.com/WeihanLi/AccessControlHelper/blob/master/samples/AccessControlDemo/Startup.cs
// Configure
app.UseAccessControlHelper();
// ConfigureServices
services.AddAccessControlHelper<ActionAccessStrategy, ControlAccessStrategy>();
asp.net core
asp.net mvc
控制 Action 的方法权限
通过 AccessControl 和 NoAccessControl Filter 来控制 Action 的访问权限，如果Action上定义了 NoAccessControl 可以忽略上级定义的 AccessControl，另外可以设置 Action 对应的 AccessKey
使用示例：
[NoAccessControl]
public IActionResult Index()
{
return View();
}
[AccessControl]
public IActionResult About()
{
ViewData["Message"] = "Your application description page.";
return View();
}
[AccessControl(AccessKey = "Contact")]
public IActionResult Contact()
{
ViewData["Message"] = "Your contact page.";
return View();
}
控制页面元素的显示
为了使用比较方便，建议在页面上导入命名空间，具体方法如下，详见 Samples：
通过 HtmlHelper 扩展方法来实现权限控制
SparkContainer
@using(Html.SparkContainer("div",new { @class="container",custom-attribute = "abcd" })) { @Html.Raw("1234") } @using (Html.SparkContainer("span",new { @class = "custom_p111" }, "F7A17FF9-3371-4667-B78E-BD11691CA852")) { @:12344 }没有权限访问就不会渲染到页面上，有权限访问的时候渲染得到的 Html 如下：
<div class="container" custom-attribute="abcd">1234</div> <span class="custome_p111">12344</span>SparkLink
@Html.SparkLink("Learn about me »", "http://weihanli.xyz",new { @class = "btn btn-default" })有权限访问时渲染出来的 html 如下：
<a class="btn btn-default" href="http://weihanli.xyz">Learn about me »</a>SparkButton
@Html.SparkButton("12234", new { @class= "btn btn-primary" })有权限访问时渲染出来的 html 如下：
<button class="btn btn-primary" type="button">12234</button>
asp.net mvc
在 项目的 Views 目录下的 web.config 文件中添加命名空间
WeihanLi.AspNetMvc.AccessControlHelper<system.web.webPages.razor> <pages pageBaseType="System.Web.Mvc.WebViewPage"> <namespaces> <add namespace="System.Web.Mvc" /> <add namespace="System.Web.Mvc.Ajax" /> <add namespace="System.Web.Mvc.Html" /> <add namespace="System.Web.Optimization"/> <add namespace="System.Web.Routing" /> <add namespace="PowerControlDemo" /> <add namespace="WeihanLi.AspNetMvc.AccessControlHelper" /><!-- add WeihanLi.AspNetMvc.AccessControlHelper--> </namespaces> </pages> </system.web.webPages.razor>asp.net core
在 Views 目录下的 _ViewImports.cshtml 中引用命名空间
WeihanLi.AspNetMvc.AccessControlHelper@using AccessControlDemo @using WeihanLi.AspNetMvc.AccessControlHelper// add WeihanLi.AspNetMvc.AccessControlHelper @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
Contact#
如果您在使用中遇到了问题，欢迎随时与我联系。
Contact me: weihanli@outlook.com