你的位置:首页 > ASP.net教程

[ASP.net教程]ASP.NET 5 入门——创建一个空项目


ASP.NET 5 入门——创建一个空项目¶

ASP.NET 5 RC1 发布已经有一个星期了,因为以前一直是bate版,很多东西都会变,因此一直没有写随笔。从今天开始,我将为大家带来一系列的 ASP.NET 5 教程。

创建一个空项目¶

虽然相信大家不会只创建个Empty的项目,但只要这个最简单,适合作为入门讨论。首先使用 Visual Studio 2015 创建一个空的项目。

注解

如果你是在使用 Linux/Mac OS,请参考 Your First ASP.NET 5 Application on a Mac


Visual Studio 2015 在Web目录下有三项可选,选择第一项会开启一个向导,在这里可选 ASP.NET 4.5 或者 ASP.NET 5 的项目。而后两项是用ASP.NET 5 创建类库和命令行程序。

../_images/create-empty-project-0.png

选择 ASP.NET 5 Empty 项目。

../_images/create-empty-project-1.png

解决方案目录结构¶

创建好项目后,在项目文件夹结构如下:

  • src
  • global.json
  • {your-solution-name}.sln

{your-solution-name}.sln 这个文件是用于Visual Studio 识别整个解决方案的,和其他类型的项目没有区别,就不做介绍了。

global.json¶

global.json 文件用于定义解决方案级别的设置,作用和 {your-solution-name}.sln 相同。那为什么还要再定义一次呢? ASP.NET 5 的目标是在全平台运行,而在非Windows平台是没有强大的IDE的,只能靠一些文本编辑器解决,此时 {your-solution-name}.sln 文件便没有意义了。global.json 默认的文件内容如下:(其中version的值取决你安装的版本)

123456

{ "projects": [ "src", "test" ], "sdk": {  "version": "1.0.0-rc1-update1", }}


projects 用于定义相关的项目所属的文件夹,也就是在哪些子文件夹下面去寻找项目,默认包含 src 文件夹。sdk 用于表明使用的SDK版本,包含 version , architecture , runtime 三个子项。在Windows下, runtime 可选 coreclrclr (默认),在Linux/Mac 下,可选 coreclrmono (默认)。由于ASP.NET 5 开始,默认的runtime非常精简,几乎什么都不包含,因此需要以Nuget包的方式下载,下载地址默认在系统文件夹(具体在哪未知)。我们可以通过 packages 强制指定下载的的文件都放在哪里。下面是一个较完整的示例:

123456789

{ "projects": [ "src", "test" ], "packages": "C:\\Program Files (x86)\\Microsoft Web Tools\\DNU", "sdk": {  "version": "1.0.0-rc1-update1",  "architecture": "x64",  "runtime": "coreclr" }}




项目目录结构¶

讨论完解决方案级别的文件结构,让我们再看看项目级别。首先,进入到 src\{your-project-name} 文件夹。文件目录如下:

  • PropertieslaunchSettings.json (仅 Windows 平台有)
  • wwwroot
  • wwwroot\web.config
  • project.json
  • project.lock.json (运行过 dnu restore 生成)
  • Dockerfile (Windows 平台没有)
  • {your-project-name}.xproj (仅 Windows 平台有)
  • Startup.cs

这里面,wwwroot就是运行时网站的根目录(可以在 project.json 内重置)。Properties 文件夹下的 launchSettings.json 是可以通过 Visual Studio 的图形化界面修改的,就不详细说明了。project.lock.json 是根据 project.json 文件生成的,重新生成可在项目目录下使用命令 dnu restore 完成,Visual Studio 2015 会在必要时自动运行此命令。下面重点介绍 project.jsonStartup.cs 两个文件。

project.json¶

project.json 主要包括了对项目的配置(如应该对哪些文件进行编译,输出时保留哪些文件,项目的依赖)和生成dll的元数据(版本号,标题,作者,版权信息等)。

默认的文件如下(综合 Windows平台与Mac平台):

比较重要(开发中常用)的是 dependencies , commands , frameworks

dependencies 包含了项目的引用及其版本,因为是空项目,只引用了两个Web服务器,IIS和Kestrel。其中Kestrel是跨平台的Web服务器。

frameworks 包含了需要编译的框架,当在非Windows平台上运行时,请只保留 "dnxcore50":{}

commands 中包含的若干命令是通过 dnx 命令运行时的可用参数。如使用 dnx web 使用默认参数启动Kestrel服务器(监听 http://localhost:5000 )也可以使用以下设置同时监听5000和5001两个端口。

注解

这种设置还可以保证所有到达5000和5001的请求全部都能被接受,而不要求url中为 localhost


"commands":{ "web":"Microsoft.AspNet.Server.Kestrel --server.urls http://*:5000;http://*:5001"}


当然也可以通过另外的json文件定义这一行为,否则每次更改都需要运行 dnu restore 命令。

"commands": { "web": "Microsoft.AspNet.Hosting --config hosting.json",}


hosting.json 文件如下:

{ "server": "Microsoft.AspNet.Server.Kestrel", "server.urls": "http://*:5000"}



Startup.cs¶

请参考我另一篇博文 ASP.NET 5 入门——Application Startup