官术网_书友最值得收藏!

Finding controllers

Regardless of whether you go for POCO or non-POCO controllers, ASP.NET Core will apply the same rules for discovering controllers, which are as follows:

  • They need to have the Controller suffix (strictly speaking, this can be changed, but we will leave this for now).
  • They need to be instantiable classes (nonabstract, nongeneric, and nonstatic).
  • They cannot have the [NonController] attribute applied to them.
  • If they are POCO and do not have the Controller suffix, you can decorate them with the [Controller] attribute.
By convention, the files that contain the controller classes are stored in a folder called Controllers, and also in a Controllers namespace, but this is just ignored.

Controller classes are looked up by the name in the route—the controller parameter—and they are searched in the assemblies registered for that purpose. By default, the currently executing assembly is included in the search, but all assemblies registered as application parts are too. You can register additional application parts when you add the MVC features to the dependency injection framework (ConfigureServices method) as follows:

services.AddMvc()
.AddApplicationPart(typeof(MyCustomComponent).GetTypeInfo().Assembly);

Here, we are adding a reference to the assembly that contains a hypothetical class, MyCustomComponent. After we do this, any controllers that are located in it are available for use. In order to get the full list of found controllers, we can use ControllerFeature and populate it through ApplicationPartManager:

services.AddMvc()
.AddApplicationPart(typeof(MyCustomComponent).GetTypeInfo().Assembly)
.ConfigureApplicationPartManager(parts =>
{
var controllerFeature = new ControllerFeature();
parts.PopulateFeature(controllerFeature);
//controllerFeature.Controllers contains the list of discovered
//controllers' types
});

Controllers are only discovered once, at startup time, which is a good thing performance-wise.

If there are two controllers with the same name but that are in different namespaces, and they both expose an action method that matches the current request, then ASP.NET won't know which one to pick and will throw an exception. If this happens, we need to give one of the classes a new controller name by applying a [ControllerName] attribute, as shown in the following code:

namespace Controllers
{
public class HomeController
{
}

namespace Admin
{
[ControllerName("AdminHome")]
public class HomeController
{
}
}
}

We could also change the action name, as we will see in a moment. Now, let's see what happens once the controller type has been found.

主站蜘蛛池模板: 天祝| 广平县| 资中县| 建宁县| 渭源县| 固安县| 托里县| 宜州市| 凤阳县| 延津县| 新津县| 北宁市| 汶上县| 辉南县| 子长县| 乌审旗| 墨玉县| 连云港市| 临高县| 瓦房店市| 平安县| 平阴县| 临沂市| 静安区| 建德市| 泾川县| 铜梁县| 九龙县| 娱乐| 临夏市| 胶州市| 铜川市| 芮城县| 保山市| 翁牛特旗| 易门县| 漯河市| 南涧| 中超| 白山市| 兴文县|