前言
上一章介绍了 Asp.Net Core 的前世今生,并创建了一个控制台项目编译并运行成功,本章的内容介绍 .NETCore 的各种常用命令、Asp.Net Core MVC 项目文件目录等信息,通过对命令的学习和操作,对项目结构的认识,进一步理解 Asp.Net Core 的运行机制和项目框架。
创建项目的命令
首先来认识一下创建项目可使用的各种命令,.NETCore 的命令都以 dotnet 打头,这很好理解,输入 dotnet xxx,就是执行环境变量指向的 C:\Program Files\dotnet\dotnet.exe 程序,然后给 dotnet.exe 提供参数运行。建议初学者以下命令逐个执行一遍,加深记忆和理解,如果实在记不住也没有关系,可以通过在控制台中输入命令
1.帮助命令
dotnet --help
// 或者
dotnet optional --help
// 如
dotnet new --help // 了解创建项目的帮助文档
2. dotnet new 创建各种类型的项目
模板 | 短名称 | 语言 |
---|---|---|
控制台应用程序 | console | [C#]、F#、VB |
类库 | classlib | [C#]、F#、VB |
单元测试项目 | mstest | [C#]、F#、VB |
xUnit 测试项目 | xunit | [C#]、F#、VB |
Razor 页 | page | [C#] |
MVC ViewImports | viewimports | [C#] |
MVC ViewStart | viewstart | [C#] |
ASP.NET Core 空 | web | [C#],F# |
ASP.NET Core Web应用程序(Model - View - Controller) | mvc | [C#],F# |
ASP.NET Core Web 应用程序 | razor | [C#] |
含 Angular 的 ASP.NET Core | angular | [C#] |
含 React.js 的 ASP.NET Core | react | [C#] |
含 React.js 和 Redux 的 ASP.NET Core | reactredux | [C#] |
ASP.NET Core Web API | webapi | [C#],F# |
Razor 类库 | razorclasslib | [C#] |
global.json 文件 | globaljson | |
NuGet 配置 | nugetconfig | |
Web 配置 | webconfig | |
解决方案文件 | sln |
- 更多命令,见
https://docs.microsoft.com/zh-cn/dotnet/core/tools/dotnet-new?tabs=netcore21
最最常用的命令有 4 个,这些命令需要在项目根目录执行
1. 创建一个 asp.net core mvc 项目,指定项目名称为 MyMvc
dotnet new mvc -o MyMvc
2. 还原项目引用包
dotnet restore
3. 编译项目
dotnet build
4. 运行项目
dotnet run
Asp.Net Core 项目结构介绍
1. 首先使用上面的命令创建一个 Asp.Net Core MVC 项目
dotnet new mvc -o MyMvc
2. 创建成功,得到一个新的 Asp.Net Core MVC 项目
打开项目文件夹,进入项目,看到一个标准的 Asp.Net Core MVC 项目结构如下
介绍各个目录和文件的作用
1. 三层架构目录
/Models
/ViewS
/Controllers
这是一个和 Asp.Net MVC 相同的三层架构 MVC 项目,包含了 模型(Models)、视图(Views)、控制器(Controllers),简单来说就是 Models 内可以定义视图(Views)通过 html 传递到 Controllers 内控制器的实体对象
2. obj 目录
该目录用于存放相关配置文件暂存项,包引用项目配置说明
3. Properties 目录
该目录用于存放程序集信息,运行配置文件、内部资源等文件,该目录在创建之初,会默认创建一个 launchSettings.json ,该文件包含了一些程序启动时的信息
{
"iisSettings": {
"windowsAuthentication": false,
"anonymousAuthentication": true,
"iisExpress": {
"applicationUrl": "http://localhost:23090",
"sslPort": 44351
}
},
"profiles": {
"IIS Express": {
"commandName": "IISExpress",
"launchBrowser": true,
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
},
"MyMvc": {
"commandName": "Project",
"launchBrowser": true,
"applicationUrl": "https://localhost:5001;http://localhost:5000",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
}
}
}
4. 无需理解太多,直接在项目根目录下输入命令启动 MVC 项目
dotnet run
你将会得到如下窗口输出信息
重点关注控制台输出的一个信息
Now listening on: https://localhost:5001
Now listening on: http://localhost:5000
该信息表示 Asp.Net Core MVC 项目已成功运行于 5001/5000 端口下,在浏览器中打开该连接地址
https://localhost:5001
再图看看 launchSettings.json 中的信息,找到下面的信息,你就了解了这个文件的作用是配置项目运行端口等信息的
"applicationUrl": "https://localhost:5001;http://localhost:5000",
5. wwwwroot
该目录存放视图层(Views) html 页面引用的静态资源,如图片、样式表、脚本文件(js)等
6. appsettings.json 和 appsettings.Development.json
项目主配置文件,两个文件格式完全相同,实际上 appsettings.Development.json 表示 开发时运行程序的配置文件,使用 appsettings.{env}.json,可以很方便进行运行环境的切换,以加载不同的配置文件
7. MyMvc.csproj 项目描述文件,用记事本打开它,看看
netcoreapp2.1
第一行表示项目是一个 web 应用程序,当前使用的 SDK 版本为 netcoreapp2.1,配置节点 ItemGroup 包含了项目引用的 Nuget 包,如有新的包引用,可以加入该 ItemGroup 配置节
8.Program.cs 文件,程序运行主入口,Main 方法所在
9.Startup.cs
- 该文件是默认文件,不可随意删除,在此文件中可以以包含服务配置、定义请求处理管道的重要操作。
结语
总的来说,这是一篇小白入门答疑,简单的介绍了一个标准的 Asp.Net Core MVC 项目都包含了哪些文件和目录,以及各自的作用,希望对未入门的同学有点帮助
- 努力为开源社区作贡献,推荐一个自己开发的基于 .netcore+pgsql 的快速开发脚手架,内置 ORM框架,github地址:https://github.com/lianggx/mystaging
- 文中如有疏漏之处,欢迎指正。