6.1 ASP.NET Core Web 入门
ASP.NET Core中,严格来讲只有一个Asp.net Core MVC一个框架,Asp.net Core MVC既支持基于视图的MVC开发,也支持Web API和Razor Pages开发。
ASP.NET Core MVC项目
在VS2022中,一定选择ASP.NET Core Web应用(模型-视图-控制器)项目模板
项目中wwwroot文件夹包含图片、JS、CSS等静态文件,Models、Views、Controllers是与MVC相关的文件夹,appsetting.json是默认配置文件,program.cs为入口代码
MVC模式包括:模型、视图和控制器三部分,视图负责展示内容,也就是html网页;控制器负责处理用户的请求和为视图准备数据;模型负责在视图和控制器之前传递数据。
MVC约定:
MVC中,控制器由Controller类实现,视图一般为*.cshtml文件,模型则是C#中的普通类。
控制器的名字一般以Controller结尾,并放在Controllers文件夹下
视图一般放到Views/控制器名称
文件夹下
模型则放在model文件夹下
工作过程
浏览器提交的请求会被封装到模型类的对象中,然后传递给控制器,控制器对其进行处理后将结果放到模型类的对象中再传给视图,视图则解析模型对象渲染成HTML输出给浏览器。
案例:
在Models文件夹下创建一个类
public record Person(string Name, bool IsVIP, DateTime CreatedTime);
在Controllers文件夹下创建一个继承自Controller类的TestController类
public class TestController : Controller { //控制器类中被外界直接访问的方法叫做操作方法 public IActionResult Demo1(int a) //返回类型为IActionResult { var model = new Person("Zack", true, new DateTime(1999, 9, 9)); return View(model);//将model对象传递给与操作方法同名的View } }
在views文件夹中创建Test子目录,然后再Test子目录中添加视图,视图名称为Demo1.cshtml
@model MVC项目1.Models.Person <div>姓名:@Model.Name</div> <div>@(Model.IsVIP?"VIP":"普通会员")</div> <div>注册时间:@Model.CreatedTime</div>
@model MVC项目1.Models.Person:视图文件是接收Person类数据的强类型视图
以@开头的代码后面跟C#语句,这种代码叫做服务器端代码
我们在访问…/Test/Demo1地址时,框架会寻找名为TestController类中的Demo1方法来处理用户的请求,运行该操作方法,则会将view渲染成HTML输出给浏览器
ASP.NET Core Web API
MVC开发的系统一般是在浏览器中查看,而目前访问服务器的客户端已不仅仅是浏览器了,很多客户端和服务器之间一般都是使用JSON结构来传递数据,所以需要将数据进行结构化,执行结构化操作的服务叫做Web API。
ASP.NET Core Web API与MVC的项目目录结构相似,但是没有Views和Models文件夹,因为Web API直接返回的是结构化数据,不需要提供展示数据的视图。
样板代码WeatherForecastController,继承自ControllerBase类,MVC中Controller类同样是继承自ControllerBase,Controller类中多了View和MVC中视图相关的代码。
[ApiController] //Web API都要加 [Route("[controller]")] //设定路由,[controller]代表控制器的名字,在这里是WeatherForecast //表示对/WeatherForecast路径的请求由WeatherForecastController来处理 public class WeatherForecastController : ControllerBase { //当对/WeatherForecast路径发送Get请求时由该方法Get处理 [HttpGet(Name = "GetWeatherForecast")] public IEnumerable<WeatherForecast> Get() {... } }
Post Put等方法
先增加一个类SaveNoteRequest,然后在WeatherForecastController中增加一个SaveNote方法,并设定[HttpPost]
public record SaveNoteRequest(string Title, string Content); [HttpPost] public string SaveNote(SaveNoteRequest req) { string filename = $"{req.Title}.txt"; System.IO.File.WriteAllText(filename, req.Content); return filename; }
可以在自带Swagger页面中进行调试查看结构数据,注意只有勾选[启用OpenAPI支持]才会生成一个接口定义浏览界面