ASP.NET入門(1) - 創建和開發ASP.NET 5 項目

原文轉載自：http://www.cnblogs.com/zergcom/p/4493358.html

創建項目

首先,目前只有VS 2015支持開發最新的ASP.NET 5 程序,因此咱們首先須要下載安裝其最新的RC版本.

https://www.visualstudio.com/en-us/downloads/visual-studio-2015-downloads-vs.aspx

安裝完畢之後,打開並創建新的Web Application項目:

              

而後在後一個界面中選擇ASP.NET 5 Empty模板:

這裏提2個注意點:

1. 要選擇下面的ASP.NET 5模板,而不是上面的4.6模板.
2. 選擇Empty模板而不是後面更完整的Web Site模板是但願可以從無到有,逐步分解這個最新的框架體系.

創建項目完成之後,咱們能夠看到以下項目結構:

 

其中global.json記錄瞭解決方案的一些配置,Project_Readme.html則是一個介紹頁面.

比較重要的文件或者文件夾是如下3個:

l  Startup.cs : 啓動類

l  project.json: 項目配置文件

l  wwwroot : 整個WebApp的靜態文件目錄(因爲最小模板沒有加載靜態文件中間件,因此該目錄內容暫時無效,這個稍後說明)

啓動類

ASP.NET 5的啓動類只有一個，這裏再也沒有Global.asax，RouteConfig等耳熟能詳的啓動文件，而只剩下這個Startup.cs是ASP.NET 5的惟一入口。

通常狀況下Startup類會包含3個主要函數: 構造函數，ConfigureServices和Configure

在最小模板下,咱們僅僅看到後面2個函數,沒有構造函數,雖然不是必須的,但構造函數在讀取初始化參數的環境下也是很是重要的,這個咱們之後再介紹.

咱們能夠這樣來理解這3個函數的做用:

構造函數: 加載各類配置文件和配置信息.

ConfigureServices: 加載各類基於依賴注入(Dependency Injection)的服務,這裏提下,在ASP.NET 5中,依賴注入技術獲得了充分的使用,大大優化了代碼的結構.

Configure: 加載各類須要的中間件(Middleware),這個概念和Owin中間件概念是一致的,和原來IIS中的HttpModule很是的相似.

配置文件

ASP.NET 5 內置標準的Config文件只有一個:  project.json. 其餘配置文件都是自定義並自行裝載的。固然，在Solution目錄有一個global.json文件，但這個和ASP.NET 5主體項目關係不大。另外在project.json之下，還隱藏了一個project.lock.json,其本質內容是記載了大量.NET運行環境(DNX)內置的組件信息，這個文件是由VS自行管理的，因此這個文件咱們目前也先略過。

關於.NET運行環境(DNX)是VS 2015之後爲適應多平臺運行環境所提出的全新的概念,這個概念對理解ASP.NET編譯和運行環境相當重要,不過此內容不在本文的討論範圍之內,若是要深刻理解,請經過我上一篇博文ASP.NET 5 (vNext) 理解和概述 中提供的超鏈來進一步學習.

那麼咱們開始進入project.json

"webroot": "wwwroot",

"version": "1.0.0-*",

前者定義了WebApp靜態文件的根目錄,通常不須要修改;後者定義了整個項目的版本號.

"dependencies": {

    "Microsoft.AspNet.Server.IIS": "1.0.0-beta4",

    "Microsoft.AspNet.Server.WebListener": "1.0.0-beta4"

  },

除了.Net運行環境DNX內置組件外,項目所需加載的外部組件,目前只有2個Server組件: IIS和控制檯,這2個組件可讓當前的WebApp運行在IIS或者控制檯程序.

這裏稍微提下,能夠經過這個配置段落的智能感知快速的給當前項目加入組件,這個牛逼的特性咱們下面詳細介紹.

"commands": {

      "web": "Microsoft.AspNet.Hosting --server Microsoft.AspNet.Server.WebListener --server.urls http://localhost:5000"

  },

這裏定義項目內部內置的各類命令,因爲控制檯Server模式必須由一個命令啓動,因此在此定義了一個web命令行.經過啓動這個命令就能啓動控制檯Server模式.通常來講,VS提供了啓動這個命令內在機制,但咱們要理解,ASP.NET實際上是經過DNX環境的核心命令dnx.exe來運行外部命令的,關於這個命令我感受目前整合的並不完美,並且這個命令存在於一個很是詭異的地方,關於這部份內容咱們再後面的博文在進一步討論.

"frameworks": {

    "dnx451": { },

    "dnxcore50": { }

  },

定義該項目能夠運行的.Net Framework版本,默認同時支持4.5.1和5.0 Core版本,去掉任何一個都是能夠的,固然要注意5.0尚未最終Release,還須要注意有些組件可能在5.0 Core版本上會有兼容問題,這個時候就必須進行取捨.

"publishExclude" 和 "exclude"主要影響發佈和編譯時的內容選擇.對主功能影響不大.

第一次運行

好,下面咱們來運行下看看是什麼效果,選擇web方式(控制檯Server)運行,會彈出一個控制檯程序:

 

而後用瀏覽器訪問http://localhost:5000 (這個URL和project.json中web command的參數配置相吻合),能夠看到 一個有「Hello World」的頁面.

爲何最小模板下會有這個頁面,咱們能夠看到其實在Startup的Configure函數中有這樣一段代碼:

 

       public void Configure(IApplicationBuilder app)
        {
            app.Run(async (context) =>
            {
                await context.Response.WriteAsync("Hello World!");
            });
        }

這裏用Lambda表達式實現了一個很是小型的中間件,固然這塊代碼沒有什麼特別意義,能夠去除.

組件管理

正如我上一篇文章全部，ASP.NET 5的組件必需經過Nuget進行管理，但實際操做中，卻能夠有2種方式。

經過Nuget安裝,這個用過VS2013的同窗都應該很是熟悉了,固然VS2015界面略有不一樣,並且更加準確,功能更完整,你們具體看一下就瞭解了.

而我想特別推薦的是第二種方式,在project.json文件的dependencies小節,直接使用智能感知進行添加.

 

加載第一個中間件 - 靜態文件StaticFile

固然首先咱們要引入StaticFile組件,利用直接修改project.json的方式,能夠進行快速的添加:

"dependencies": {

    "Microsoft.AspNet.Server.IIS": "1.0.0-beta4",

    "Microsoft.AspNet.Server.WebListener": "1.0.0-beta4",

    //Static Files

    "Microsoft.AspNet.StaticFiles": "1.0.0-beta4"

  },

修改並保存以後,VS會自動把這個組件加載到當前項目的全部Framework中:

 

下面咱們來加載靜態文件的中間件,咱們知道,全部中間件是經過Startup的Configure函數來加載的,咱們把這個函數原有的代碼替換爲以下代碼.

  

     public void Configure(IApplicationBuilder app)
        {
            //加載靜態文件中間件
            app.UseStaticFiles();
        }

根據前面的說明咱們知道靜態文件中間件會把根目錄默認設定爲wwwroot,下面咱們再這個目錄下創建一個index.html,裏面放入任何內容.

 

這時候再次啓動整個項目(web方式)經過http://localhost:5000/index.html 就能夠訪問到這個頁面. (反之,若是你沒有添加app.UseStaticFiles();這個頁面是訪問不到的)

下面咱們稍微擴充下,若是咱們想把index.html設置爲咱們的默認文檔,咱們應該如何去作,其實很簡單,在StaticFiles組件中,還提供了另一箇中間件來實現這個功能,咱們回到Configure函數再加入以下代碼便可:

        public void Configure(IApplicationBuilder app)
        {
            //設定靜態文件的默認文檔
            app.UseDefaultFiles(new DefaultFilesOptions()
            {
                DefaultFileNames = new string[] { "index.html" }
            });
            //加載靜態文件中間件
            app.UseStaticFiles();
        }

這個時候須要引入

using Microsoft.AspNet.StaticFiles;

另外UserDefaultFIles必須在UserStaticFiles以前運行.

而後從新啓動項目,會發現直接訪問 http://localhost:5000 就能看到index.html頁面.

 

固然StaticFiles中間件僅僅是一個起步,一個真正有意義的Web Application還須要更多的內容,下面我會依次介紹在ASP.NET 5項目中如何加入MVC 6, WebApi 2, Entity Framework 7, MS Identity 3的實現方法. 敬請期待.

軟件開發,項目管理,開發管理,團隊管理. CMMI,PMP