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

时间 2019-12-12

标签 asp.net asp core 2.2 mvc 入门基本使用系列栏目 ASP 繁體版

原文原文链接

本教程会对基本的.Net Core 进行一个大概的且不会太深刻的讲解, 在您看完本系列以后, 能基本甚至熟练的使用.Net Core进行Web开发, 感觉到.Net Core的魅力.数据库

本教程知识点大致分为如下几个阶段json

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 判断, 就能够作到环境的自动切换, 下面就仔细说说.app

咱们先经过默认的.Net Core MVC设置, 感觉一下. 之前的代码找不到了, 新建一个空的.Net Core MVC项目吧, 代码后面会上传到百度云, 提供下载. async

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", 如图:

F5执行, 浏览器输出了appsettings.json, 没问题

而后咱们点一下appsettings.json文件前面的箭头, 会发现里面还有个appsettings.Development.json文件, 如图:

打开appsettings.Development.json文件, 在里面和配置appsettings.json同样, 添加个hello配置, 把值设置为appsettings.Development.json, 如图:

而后再F5运行, 浏览器输出的就是appsettings.Development.json啦~, 这里的缘由, 前面章节已经讲过, 这里再也不称述.

咱们新建个appsettings.Cus.json文件, 而后在里面加个hello配置, 值为appsettings.Cus.json, 如图:

而后再修改运行环境为Cus, 修改方法参考上面, 而后F5运行, 浏览器就输出appsettings.Cus.json啦~

到这里, 这一节就结束了, 到目前为止, 咱们对.Net Core MVC的环境和配置文件切换, 有了一个比较熟悉的了解了, 能够实际运用一下了, 不再用担忧不一样环境不一样的配置搞混了

咱们再下一节讲ASP.Net Core MVC的路由

若是在使用.Net Core遇到任何问题, 都加群进行讨论, 群号: 1群: 225982985. 2群: 726648662. 3群: 654015377

本节代码: 连接: https://pan.baidu.com/s/1r98sWbVdM6UMtzUEgztY2A 提取码: 6e35