ASP.Net Core -- 属性路由
属性路由示例
今天讨论 ASP.NETCoreMVC 中的属性路由
在Startup.cs中使用UseMvc()方法：请注意，我们使用UseMvc()方法,所以不包含默认路由模板，无法进行参数传递
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
app.UseStaticFiles();
app.UseMvc();
}
使用属性路由，我们使用Route()属性来定义路由。我们可以在Controller或 Controller 的操作方法上应用Route属性。
public class DepartmentController : Controller
{
[Route("")]
[Route("Department")]
[Route("Department/List")]
public string List()
{
return "你好，我是list";
}
public string Infor()
{
return "你好，我是infor";
}
}
在List()操作方法上指定了 3 个不同的Route()属性。对于Route()属性的每个实例，我们指定了不同的路由模板。使用这 3 个路由模板，3 个 URL 路径中，都会访问 DepartmentController的 List()操作方法。
使用这 3 个路由模板,当遇到以下 3 种 url 地址进行访问DepartmentController的List()操作方法的时候，都会匹配成功，进入方法内。
属性路由参数
使用传统路由，我们可以将路由参数指定为路由模板的一部分，比如，在Index()中传一个主键等等。 当然属性路由也可以做同样的事情。
public class DepartmentController : Controller
{
private readonly IStudentRepository _studentRepository;
//使用构造函数注入的方式注入IStudentRepository
public DepartmentController(IStudentRepository studentRepository)
{
_studentRepository = studentRepository;
}
[Route("Home/Details/{id}")]
public IActionResult Details(int id)
{
//实例化HomeDetailsViewModel并存储Student详细信息和PageTitle
HomeDetailsViewModel homeDetailsViewModel = new HomeDetailsViewModel()
{
Student = _studentRepository.GetStudent(id),
PageTitle = "学生详细信息"
};
return View(homeDetailsViewModel);
}
}
Details ()操作方法具有 id 参数。此参数根据指定的 id 来查询学生的详细信息 。请注意, 在路由模板中, 我们指定了 id 参数。因此, URL (/Department/Details)将执行Details (int id)操作方法, 并将值"1"映射到Details(int id)的"id"参数
属性路由可选参数
当前，当我们在URL（/ Department/ Details / 1）中具有“id”路由参数的值时，才执行DepartmentController的Details（int id）操作方法。 如果 id 值不在 URL 中，我们得到 404. 例如，URl / Department/ Details不会执行Details（int id）操作方法。 而是显示 404 错误。 要使路由参数“id”可选，只需在末尾添加“？” 即可。
public class DepartmentController : Controller
{
private readonly IStudentRepository _studentRepository;
//使用构造函数注入的方式注入IStudentRepository
public DepartmentController(IStudentRepository studentRepository)
{
_studentRepository = studentRepository;
}
[Route("Home/Details/{id?}")]
public IActionResult Details(int id)
{
//实例化HomeDetailsViewModel并存储Student详细信息和PageTitle
HomeDetailsViewModel homeDetailsViewModel = new HomeDetailsViewModel()
{
Student = _studentRepository.GetStudent(id),
PageTitle = "学生详细信息"
};
return View(homeDetailsViewModel);
}
}
控制器和操作方法名称
在属性路由中，控制器名称和操作方法名称,不会影响路由属性名称，他们没有强关联关系。 路径名称我们自己定义，然后根据自己的定义进行查找对应的控制器和方法。
public class DepartmentController : Controller
{
[Route("")]
[Route("Home")]
[Route("Home/Index")]
public ViewResult Department()
{
return View();
}
}
通过以下三种方式依然可以查找到：
/
/Home
/Home/Index
属性路由支持层次结构
在 HomeController 类上应用Route（）属性，如下所示。主要降低代码重复
namespace StudentManagement.Controllers
{
[Route("Department")]
public class DepartmentController : Controller
{
[Route("/")]
[Route("List")]
public string List()
{
return "你好，我是list";
}
[Route("Infor/{id}")]
public string Infor(int id)
{
return "你好，我是infor";
}
}
}
这样，项目启动，就会直接找到Department控制器下的List方法，如果[Route("/")]中不加斜杠，直接启动项目会报错，说找不到页面，需要带上控制器名称才能找到，加上的话直接启动就会找到
属性路由中自定义路由
[Route("[controller]")]
public class DepartmentController : Controller
{
[Route("[action]")]
public string List()
{
return " DepartmentController控制器中的List()方法";
}
[Route("[action]")]
public string Details()
{
return " DepartmentController控制器中的Details()方法";
}
}
使用 controller 和 action 标记，在 URL 路径中的/Departments/List将进入DepartmentsController中执行List（）方法。 类似地，在 URL 路径中的/ Departments / Details将进入DepartmentsController中执行Details（）方法。如果我们要进行重命名控制器或动作名称，我们就不必更改路径模板。
要使 List（）方法成为 DepartmentController 的默认路由入口，可以使用空字符串包含的 Route（“”）属性，如下所示。
[Route("[controller]")]
public class DepartmentController : Controller
{
[Route("[action]")]
[Route("")] // 使 List()成为默认路由入口
public string List()
{
return " DepartmentController控制器中的List()方法";
}
[Route("[action]")]
public string Details()
{
return " DepartmentController控制器中的Details()方法";
}
}
我们最好在控制器上只设置一次，而不是在控制器中的每个操作方法中包含[action]标记，如下所示
[Route("[controller]/[action]")]
public class DepartmentController : Controller
{
public string List()
{
return " DepartmentController控制器中的List()方法";
}
}
这样减少代码重复。
