关于如何配置.net3.1框架 - (第二十讲)

视频讲解如下：

工程源码下载：GPS定位系统系列教程源码下载

1、新建工程

        到目前为止，我们采用的框架都是.net6.0，如果想使用.net3.1框架来搭建上位机系统的，可以参考本章节。当前章节只描述如何新建工程，以及相关的配置，应用程序部分和前面讲的是一样的，我这边就不讲了，代码完全是copy过来的。

        首先呢，新建部分请参考第一讲《新建.net core web工程》，唯一不同点是在选择.net版本时，我们需要选择.net3.1，HTTPS不能勾选，不然迁移之后，系统会以https进行访问，导致地图无法加载。如下：

2、添加MVC支持

修改Program.cs文件，使asp对支持IIS，同时定义web访问的端口，默认的Program类如下：

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace DataServer
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateHostBuilder(args).Build().Run();
        }
        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseStartup<Startup>();
                });
    }
}

将其进行如下修改：

using Microsoft.AspNetCore; // 新增引用
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;
using System.IO; // 新增引用

namespace WebApplicationGPS
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateWebHostBuilder(args).Build().Run(); // 重新修改接口名称
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
           WebHost.CreateDefaultBuilder(args)
               .UseUrls("http://localhost:5072", "http://*:5071")// 使web主机主动监听的url，使用非IIS运行时，使用这个链接
               .UseKestrel()                                     // 使用kestrel server来处理请求
               .UseContentRoot(Directory.GetCurrentDirectory())  // 设置站点目录
               .UseIISIntegration().UseIIS()                     // 告诉ASP.NET IIS将在Kestrel之前充当反向代理。
               .UseStartup<Startup>();                           // 启动Startup
    }
}

修改Startup.cs文件，使asp对mvc支持，同时在这里面启动我们的后台应用ServerInit，修改内容请对照如下代码。

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

namespace WebApplicationGPS
{
    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
        {
            // 添加分布式缓存
            services.AddDistributedMemoryCache();
            // 添加应用程序会话状态所需的服务。在web访问时，确保变量信息不丢失
            services.AddSession();
            // 配置Mvc
            services.AddMvc(options => { options.EnableEndpointRouting = false; });
        }

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

            app.UseStaticFiles(new StaticFileOptions
            {
                //设置不限制content-type
                ServeUnknownFileTypes = true
            });

            app.UseCookiePolicy();
            app.UseSession();
            app.UseMvc(routes =>
            {
                routes.MapRoute(
                    name: "default",
                    template: "{controller=Login}/{action=Error}/{id?}");

                // 默认页面的目录设置
                // views 是我们的项目目录下的一个views文件夹，Home是二级文件夹，Index是主页面
                routes.MapRoute(
                    name: "views",
                    template: "{controller=Login}/{action=Index}/{id?}");
            });

            // 后台程序启动
            new ServerInit(Configuration.GetValue<string>("ConnectionStrings:mysql"));
        }
    }
}

3、应用程序迁移

        请参照前面.net6.0的工程搭建过程，将我们.net6.0的所有应用程序迁移到我们.net3.1中。迁移时，别忘了修改appsettings.json文件。

        DbEntity和Link两个类库也要新建，修改.net版本为3.1，如下：

3.1的数据库依赖包和6.1的有点差异，如果是mysql数据库，所有依赖包版本如下：

如果是SqlServer数据库，所有依赖包版本如下：

迁移完成之后，编译一下，中间可能会有很多下面这样的提示，我们只要把缺失的引用补上即可。

当编译成功后，.net3.1的工程就搭建完成了，这里你可以用下位机模拟器跑一下，效果和.net6.1的效果是一样的，发布方法也和.net6.1的一样。