此教程将向你解释如何创建新的控制器action,学到action方法的要求,还可以学到如何防止方法被暴露为action。
向控制器添加Action
为控制器添加action就是为控制器添加一个新的方法。例如,代码1中的控制器包含一个名为Index()和一个名为SayHello()。两个方法都暴露为action。
代码 1 – Controllers/HomeController.cs
一个方法要向外界暴露为action,必须满足几个要求:
- 方法必须是公共的。
- 不能是静态方法。
- 不能是扩展方法。
- 不能是构造函数,属性赋值器(getter)或取值器(setter)。
- 不能有公开的泛型类型。
- 不能是控制器基类的方法。
- 不能包含 ref 或者 out 参数。
注意对控制器action的返回值并没有严格要求。控制器action可以返回string,DateTime,Random类的实例,或者void。 ASP.NET MVC框架会将不是action result的返回值转换为string并将这个string呈现到浏览器。
当你遵照上述要求向控制器添加方法时,这个方法就会被暴露为一个action。这里要小心,控制器action可以被任何连接到Internet的人调用。可千万不要创建 DeleteMyWebsite() 控制器 action。
防止公共方法被调用
如果你需要在控制器类里创建一个公共方法而不想它被暴露为控制器action,那么可以使用[NonAction]特性来防止方法被调用。例如,代码 2 中的控制器包含了一个名为 CompanySecrets() 的公共方法,以 [NonAction] 特性修饰。
代码2 – Controllers/WorkController.cs
如果你试图在浏览器地址栏中输入 /Work/CompanySecrets 调用 CompanySecrets() 控制器action 那么你会得到图1所示的错误信息。