ASP.Net Core 2.2 MVC入門到基本使用系列 (五)

丶亡我之心不死發表於2019-06-11

ASP.NETMVC

本教程會對基本的.Net Core 進行一個大概的且不會太深入的講解, 在您看完本系列之後, 能基本甚至熟練的使用.Net Core進行Web開發, 感受到.Net Core的魅力.

本教程知識點大體分為以下幾個階段

ASP.Net Core MVC基礎知識

Startup基本配置和理解
Controller使用
Razor檢視
傳統檢視
Model Validation (基本用法)
一點點的Vue (教程使用Vue配合)

SqlSugar ORM (進行資料庫互動)
Entity Framework Core(基本介紹使用)
授權和身份驗證(MVC的, WebApi的不進行介紹)
安全性
測試 / 單元測試
效能基本優化
日誌功能
CI/CD
Windows部署
Linux部署

上一節我們介紹了中介軟體的基本使用, 這一節我們講一講.Net Core的環境設定, 以及根據不同的環境載入不同的配置資訊

PS: 由於最近一直比較忙, 一直沒抽時間更新這個系列, 最近居多的博友催我, 所以繼續擠擠時間更新這個系列, 感謝大家的對本系列教程的喜歡和支援.

在實際開發中, 我們的系統往往會是至少兩個以上的執行環境, 最基本的就是, 開發環境和運營環境, 體系完整的公司, 還會有測試環境, 預釋出環境, 和一些自定義環境等等, 這些環境使用的配置或是一些引數肯定是不一樣的, 我們不可能為一個環境準備一份程式碼, 我們可以通過環境配置, 和一些 if 判斷, 就可以做到環境的自動切換, 下面就仔細說說.

我們先通過預設的.Net Core MVC設定, 感受一下. 以前的程式碼找不到了, 新建一個空的.Net Core MVC專案吧, 程式碼後面會上傳到百度雲, 提供下載.

PS: IDE我已經使用VS2019

建好之後, 我們開啟Startup.cs程式碼檔案, 看Configure方法, 我相信, 有的博友已經發現了, 裡面的第一行程式碼是個if, 意思就是判斷當前環境是不是開發環境, 看單詞的字面意思也是這個意思, 所以學好英文對開發程式有很大的buff加成啊~~~

對於if裡的是什麼, 上一節已經講過, 不再稱述.

由此我們得出, 控制環境和判斷環境, 都是在Configure方法中, 注入的IHostingEnvironment介面物件進行的. 這裡我說一下, 系統預設提供的幾個判斷環境的方法. 我們使用env.Is, VS的智慧提示, 可以得到下面四個方法, 如圖:

IsDevelopment方法大家已經知道了, 判斷當前是不是開發環境.

IsProduction方法, 判斷當前是不是運營(正式)環境

IsStaging方法, 判斷當前是不是預執行環境

IsEnvironment方法, 根據傳入的環境名稱, 判斷是不是當前環境型別 (用於自定義環境判斷)

我們修改一下Configure方法的程式碼, 修改後為:

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.Run(async (context) =>
            {
                context.Response.ContentType = "text/plain;charset=utf-8";  //防止WriteAsync方法輸出中文亂碼
                if (env.IsDevelopment())
                {
                    await context.Response.WriteAsync("開發環境", Encoding.UTF8);
                }
                else if (env.IsProduction())
                {
                    await context.Response.WriteAsync("運營環境", Encoding.UTF8);
                }
                else if (env.IsStaging())
                {
                    await context.Response.WriteAsync("預釋出環境", Encoding.UTF8);
                }
                else
                {
                    await context.Response.WriteAsync("自定義環境", Encoding.UTF8);
                }
            });
        }

然後F5執行, 瀏覽器會不出意外的輸出: "開發環境"

沒毛病, 我們修改一下編譯環境, 把Debug修改為Release, 然後生成, 如圖:

然後生成專案, 生成成功之後, 到專案的bin/Release/netcoreapp2.2目錄下, 開啟CMD, 執行dotnet Unit1.dll命令, 就會是這樣的, 如圖:

我們在瀏覽器輸入 http://localhost:5000/回車, 不出意外, 會輸出: 運營環境四個大字.

以上的流程, 就演示了最基本的開發環境和運營環境的配置和判斷. 下面我們演示自定義環境. 我們接著修改程式碼, 為當前環境設定個名字, 程式碼如下

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            env.EnvironmentName = "Cus";    //設定自定義環境名稱

            app.Run(async (context) =>
            {
                context.Response.ContentType = "text/plain;charset=utf-8";  //防止WriteAsync方法輸出中文亂碼
                if (env.IsDevelopment())
                {
                    await context.Response.WriteAsync("開發環境", Encoding.UTF8);
                }
                else if (env.IsProduction())
                {
                    await context.Response.WriteAsync("運營環境", Encoding.UTF8);
                }
                else if (env.IsStaging())
                {
                    await context.Response.WriteAsync("預釋出環境", Encoding.UTF8);
                }
                else
                {
                    await context.Response.WriteAsync("自定義環境", Encoding.UTF8);
                }
            });
        }

F5執行專案, 瀏覽器毫不意外的輸出了: 自定義環境

如果我們要輸出 預釋出環境 的話, 只需要把 EnvironmentName 屬性的值改成 "Staging" 即可, 這裡不做演示, 自行嘗試, 設定程式碼如下:

env.EnvironmentName = "Staging"; //設定為預釋出環境

發設定為Staging和其它值的區別就是系統系統了一個IsStaging方法

為了更加直觀的演示自定義環境, 我們把else改一下, 改完之後的程式碼如下:

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            env.EnvironmentName = "Cus";    //設定自定義環境名稱

            app.Run(async (context) =>
            {
                context.Response.ContentType = "text/plain;charset=utf-8";  //防止WriteAsync方法輸出中文亂碼
                if (env.IsDevelopment())
                {
                    await context.Response.WriteAsync("開發環境", Encoding.UTF8);
                }
                else if (env.IsProduction())
                {
                    await context.Response.WriteAsync("運營環境", Encoding.UTF8);
                }
                else if (env.IsStaging())
                {
                    await context.Response.WriteAsync("預釋出環境", Encoding.UTF8);
                }
                else
                {
                    if (env.IsEnvironment("Cus"))
                    {
                        await context.Response.WriteAsync("自定義環境: Cus", Encoding.UTF8);
                    }
                    else if (env.IsEnvironment("Cus1"))
                    {
                        await context.Response.WriteAsync("自定義環境: Cus1", Encoding.UTF8);
                    }
                    else
                    {
                        await context.Response.WriteAsync($"自定義環境: {env.EnvironmentName}", Encoding.UTF8);
                    }
                }
            });
        }

具體執行效果和預計的一樣, 會輸出對應的自定義環境

但是實際開發過程中, 我不推薦在程式碼裡面修改當前環境, 而且通過專案的環境變數設定對應的環境, 具體修改方法如下

1: 點開Properties

2: 開啟launchSettings.json

3: 修改ASPNETCORE_ENVIRONMENT的值.

我們修改EnvironmentName屬性的程式碼刪掉, 修改launchSettings.json的配置為Cus, 執行是什麼效果, 修改後的效果如圖

沒出任何以外, 瀏覽器輸出的是自定義環境: Cus, 改成其它的值, 就輸入對應的自定義環境, 修改為Development就是開發環境, Staging就是預運營環境, Production就是運營環境

可能有人就要問了, 你只修改了上面的ASPNETCORE_ENVIRONMENT, 下面還有一個ASPNETCORE_ENVIRONMENT配置, 沒修改, 怎麼也可以. 別急, 馬上就說明

.Net Core MVC程式, 提供了兩種託管方式, 一種是通過IIS託管, 一種是自託管, 我們剛剛修改的環境, 只修改了IIS託管模式, VS預設又是IIS除錯, 所以, 會有效果

如果使用自託管模式除錯或釋出執行程式, 則修改下面的Unit1節點的配置即可. 當然, VS也提供了除錯方式, 切換方法, 點選執行模式即可, 如圖:

選擇Unit1, 就是自託管模式啦~ , 然後F5執行, 瀏覽器輸出的依然是開發環境, 雖然IIS配置的是Cus環境, 但是Unit1自託管沒有修改, 我們修改一下Unit1的環境試試, 這裡我修改為Cus100, 然後選擇Unit1除錯, F5執行, 瀏覽器輸出的就是

沒有任何問題

如果你覺得這種修改方式麻煩, 還有一種介面修改方法

我們在專案上右鍵 --> 屬性 --> 除錯, 就能看到對應的配置了, 如圖:

當前是自託管模式, 我修改為Cus100, 這裡顯示的就是Cus100, 點選上面的配置檔案, 還可以修改不同的託管模式的配置:

這裡就不做演示了, 修改效果和直接修改launchSettings.json檔案是一樣的

-------------------------------------------------------------------------------分割線-------------------------------------------------------------------------------

PS: 我們已經把兩種託管模式的環境都設定為了預設的Development, 開發環境.

上面已經講完了環境的配置和切換, 下面講講根據不同的環境, 自動讀取不同的配置檔案, 我們先修改一下程式碼, 讓輸入的檔案是從appsettings.json配置裡面讀取的, 修改後的Startup類程式碼如下:

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using System.Text;

namespace Unit1
{
    public class Startup
    {
        private readonly IConfiguration _Configuration;

        /// <summary>
        /// 
        /// </summary>
        /// <param name="configuration">注入或者配置檔案的介面物件</param>
        public Startup(IConfiguration configuration)
        {
            this._Configuration = configuration;
        }

        // This method gets called by the runtime. Use this method to add services to the container.
        // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
        public void ConfigureServices(IServiceCollection services)
        {
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            //env.EnvironmentName = "Cus1";    //設定自定義環境名稱

            app.Run(async (context) =>
            {
                context.Response.ContentType = "text/plain;charset=utf-8";  //防止WriteAsync方法輸出中文亂碼
                var msg = this._Configuration.GetValue<string>("hello");
                await context.Response.WriteAsync(msg, Encoding.UTF8);
                /*if (env.IsDevelopment())
                {
                    await context.Response.WriteAsync("開發環境", Encoding.UTF8);
                }
                else if (env.IsProduction())
                {
                    await context.Response.WriteAsync("運營環境", Encoding.UTF8);
                }
                else if (env.IsStaging())
                {
                    await context.Response.WriteAsync("預釋出環境", Encoding.UTF8);
                }
                else
                {
                    if (env.IsEnvironment("Cus"))
                    {
                        await context.Response.WriteAsync("自定義環境: Cus", Encoding.UTF8);
                    }
                    else if (env.IsEnvironment("Cus1"))
                    {
                        await context.Response.WriteAsync("自定義環境: Cus1", Encoding.UTF8);
                    }
                    else
                    {
                        await context.Response.WriteAsync($"自定義環境: {env.EnvironmentName}", Encoding.UTF8);
                    }
                }*/
            });
        }
    }
}

然後我們在appsettings.json配置中, 新增一行: "hello": "appsettings.json", 如圖: