NET Framework项目移植到NET Core上遇到的一系列坑

原文:NET Framework项目移植到NET Core上遇到的一系列坑

本文链接：https://blog.csdn.net/zt102545/article/details/87968865

1.获取请求的参数

2.获取完整的请求路径

8.webconfig的配置移植到appsettings.json

9.设置区域块MVC的路由器和访问区域块的视图

10.NetCore访问静态资源文件

11.MVC调用子页视图

12.过滤器

13.使用session和解决sessionID一直变化的问题

14.MD5加密

15.Path.Combine()

16.DateTime

1.获取请求的参数

NET Framework版本：


Request["xxx"];
Request.Files[0];

NET Core版本：


Request.Form["xxx"];
Request.Form.Files[0];

2.获取完整的请求路径

NET Framework版本：

Request.RequestUri.ToString();

NET Core版本：


//先添加引用
using Microsoft.AspNetCore.Http.Extensions;
//再调用
Request.GetDisplayUrl();

3.获取域名

NET Framework版本：

HttpContext.Current.Request.Url.Authority

NET Core版本：

HttpContext.Request.Host.Value

4.编码

NET Framework版本：


System.Web.HttpContext.Current.Server.UrlEncode("<li class=\"test\"></li>")
"%3cli+class%3d%22test%22%3e%3c%2fli%3e"
System.Web.HttpContext.Current.Server.UrlDecode("%3cli+class%3d%22test%22%3e%3c%2fli%3e")
"<li class=\"test\"></li>"

NET Core版本：


//两种方法，建议用System.Web.HttpUtility
System.Web.HttpUtility.UrlEncode("<li class=\"test\"></li>");
"%3cli+class%3d%22test%22%3e%3c%2fli%3e"
System.Web.HttpUtility.UrlDecode("%3cli+class%3d%22test%22%3e%3c%2fli%3e");
"<li class=\"test\"></li>"
 
System.Net.WebUtility.UrlEncode("<li class=\"test\"></li>")
"%3Cli+class%3D%22test%22%3E%3C%2Fli%3E"
System.Net.WebUtility.UrlDecode("%3Cli+class%3D%22test%22%3E%3C%2Fli%3E")
"<li class=\"test\"></li>"
System.Net.WebUtility.UrlDecode("%3cli+class%3d%22test%22%3e%3c%2fli%3e")
"<li class=\"test\"></li>"

5.文件上传的保存方法

NET Framework版本：


var file = Request.Files[0];
//blockFullPath指保存的物理路径
file.SaveAs(blockFullPath);

NET Core版本：


var file = Request.Form.Files[0];
//blockFullPath指保存的物理路径
using (FileStream fs = new FileStream(blockFullPath, FileMode.CreateNew))
{
    file.CopyTo(fs);
    fs.Flush();
}

6.获取物理路径

NET Framework版本：


//作为一个全局变量获取物理路径的方法
public string ffmpegPathc = System.Web.Hosting.HostingEnvironment.MapPath("~/Content/ffmpeg/ffmpeg.exe");
//获取在控制器的构造函数里直接调用Server.MapPath
ffmpegPathc = Server.MapPath("~/Content/ffmpeg/ffmpeg.exe");

NET Core版本：

从ASP.NET Core RC2开始，可以通过注入 IHostingEnvironment 服务对象来取得Web根目录和内容根目录的物理路径。代码如下：


    [Area("Admin")]
    public class FileUploadController : Controller
    {
        private readonly IHostingEnvironment _hostingEnvironment;
 
        public string ffmpegPathc = "";//System.Web.Hosting.HostingEnvironment.MapPath("~/Content/ffmpeg/ffmpeg.exe");
 
        public FileUploadController(IHostingEnvironment hostingEnvironment)
        {
            _hostingEnvironment = hostingEnvironment;
            ffmpegPathc = _hostingEnvironment.WebRootPath + "/Content/ffmpeg/ffmpeg.exe";
        }
    }

这样写每个控制器就都要写一个构造函数，很麻烦，所以可以把它抽离出来，写个公共类去调用。代码如下：

先自定义一个静态类：


using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using System;
 
namespace GDSMPlateForm
{
    public static class HttpHelper
    {
        public static IServiceProvider ServiceProvider { get; set; }
 
        public static string GetServerPath(string path)
        {
            return ServiceProvider.GetRequiredService<IHostingEnvironment>().WebRootPath + path;
        }
    }
}

然后在startup类下的Configure 方法下：

HttpHelper.ServiceProvider = app.ApplicationServices;

startup下的ConfigureServices放下注册方法（这一步必不可少，但是这里可以不写，因为IHostingEnvironment 是微软默认已经帮你注册了，如果是自己的服务，那么必须注册）。

services.AddSingleton<IHostingEnvironment, HostingEnvironment>();

最后获取物理路径就可以这样直接调用了：

public string ffmpegPathc = HttpHelper.GetServerPath("/Content/ffmpeg/ffmpeg.exe");

7.返回Json属性大小写问题

NET Core返回Json属性默认都会自动转为小写，但项目之前Json属性有些是大写的，所以需要配置成不转化为小写的形式。

Startup.cs的ConfigureServices方法下添加一行代码：


//Startup需要添加引用
using Newtonsoft.Json.Serialization;
//返回Json属性默认大小写
services.AddMvc().AddJsonOptions(o => { o.SerializerSettings.ContractResolver = new DefaultContractResolver(); });

8.webconfig的配置移植到appsettings.json

NET Framework版本：

直接可以读取webconfig配置文件：

string format = System.Configuration.ConfigurationManager.AppSettings["format"].ToString();

NET Core版本：

NET Core不再支持web.config，取而代之的是appsettings.json，所以需要把一些配置移植过去。

例如web.config下的一些配置


<appSettings>
  <add key="ismdb" value="" />
  <add key="webpath" value="" />
  <add key="format" value="jpg,jpeg,png,gif,bmp,tif,svg/mp3,wav/mp4,avi,mpg,wmv,mkv,rmvb,mov,flv/zip/.ppt,.pptx" />
  <add key="imagesize" value="5242880" />
  <!--1024 * 1024 * 5 -->
  <add key="musicsize" value="20971520" />
  <!--1024 * 1024 * 20 -->
  <add key="mediasize" value="20971520" />
  <!--1024 * 1024 * 20 -->
  <add key="packagesize" value="0" />
  <add key="pptsize" value="0" />
</appSettings>

移植到appsettings.json


{
  "Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "webpath": "",
  "format": "jpg,jpeg,png,gif,bmp,tif,svg/mp3,wav/mp4,avi,mpg,wmv,mkv,rmvb,mov,flv/zip/.ppt,.pptx",
  "imagesize": "5242880",
  "musicsize": "20971520",
  "mediasize": "20971520",
  "packagesize": "0",
  "pptsize": "0"
}

然后编写一个类去调用这个appsettings.json


using Microsoft.Extensions.Configuration;
using System.IO;
 
namespace GDSMPlateForm
{
    public class RConfigureManage
    {
        public static string GetConfigure(string key)
        {
 
            //添加 json 文件路径
            var builder = new ConfigurationBuilder().SetBasePath(Directory.GetCurrentDirectory()).AddJsonFile("appsettings.json");
            //创建配置根对象
            var configurationRoot = builder.Build();
 
            //取配置根下的 name 部分
            string secvalue = configurationRoot.GetSection(key).Value;
            return secvalue;
        }
    }
}

调用的方式：

string format = RConfigureManage.GetConfigure("format");

9.设置区域块MVC的路由器和访问区域块的视图

NET Framework版本：

NET Framework新建一个区域会自带一个类设置路由器的，如图：


using System.Web.Mvc;
 
namespace GDSMPlateForm.Areas.Admin
{
    public class AdminAreaRegistration : AreaRegistration 
    {
        public override string AreaName 
        {
            get 
            {
                return "Admin";
            }
        }
 
        public override void RegisterArea(AreaRegistrationContext context) 
        {
            context.MapRoute(
                "Admin_default",
                "Admin/{controller}/{action}/{id}",
                new { action = "Index", id = UrlParameter.Optional }
            );
        }
    }
}

NET Core版本：

NET Core新建一个区域不会自带一个类用于设置路由器，所以需要在Startup类的Configure方法里多加一条路由器设置


app.UseMvc(routes =>
{
    routes.MapRoute(
        name: "areas",
        template: "{area:exists}/{controller=Home}/{action=Index}/{id?}"
    );
});

然后需要在每个控制器下添加一个标签，指定该控制器属于哪个区域的，如图：

不加的话访问不到区域的视图，报404错误。

10.NetCore访问静态资源文件

NET Framework版本：

NET Framework可以在webconfig下配置这些静态资源文件


<staticContent>
    <mimeMap fileExtension="." mimeType="image/svg+xml" />
    <mimeMap fileExtension=".properties" mimeType="application/octet-stream" />
</staticContent>

NET Core版本：

NET Core并没有webconfig，所以需要在Startup类的Configure方法里自己配置。

NET Core项目默认的资源文件存在wwwroot下，可以通过app.UseStaticFiles方法自己定义资源文件的路径还有类型。


var provider = new FileExtensionContentTypeProvider();
provider.Mappings[".properties"] = "application/octet-stream";
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
    Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "Content")),
    RequestPath = "/Content",
    ContentTypeProvider = provider
});

11.MVC调用子页视图

NET Framework版本：

@Html.Action("UserBackView", "UserManage")

NET Core版本：

NET Core不再支持Html.Action(),不过可以手动自己去实现它。

自定义一个静态类 HtmlHelperViewExtensions，命名空间设置为 Microsoft.AspNetCore.Mvc.Rendering。网上找的一个类，复制过来就行了，如下：


using Microsoft.AspNetCore.Html;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc.Infrastructure;
using Microsoft.AspNetCore.Routing;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.IO;
using System.Threading.Tasks;
 
namespace Microsoft.AspNetCore.Mvc.Rendering
{
    public static class HtmlHelperViewExtensions
    {
        public static IHtmlContent Action(this IHtmlHelper helper, string action, object parameters = null)
        {
            var controller = (string)helper.ViewContext.RouteData.Values["controller"];
 
            return Action(helper, action, controller, parameters);
        }
 
        public static IHtmlContent Action(this IHtmlHelper helper, string action, string controller, object parameters = null)
        {
            var area = (string)helper.ViewContext.RouteData.Values["area"];
 
            return Action(helper, action, controller, area, parameters);
        }
 
        public static IHtmlContent Action(this IHtmlHelper helper, string action, string controller, string area, object parameters = null)
        {
            if (action == null)
                throw new ArgumentNullException("action");
 
            if (controller == null)
                throw new ArgumentNullException("controller");
 
 
            var task = RenderActionAsync(helper, action, controller, area, parameters);
 
            return task.Result;
        }
 
        private static async Task<IHtmlContent> RenderActionAsync(this IHtmlHelper helper, string action, string controller, string area, object parameters = null)
        {
            // fetching required services for invocation
            var serviceProvider = helper.ViewContext.HttpContext.RequestServices;
            var actionContextAccessor = helper.ViewContext.HttpContext.RequestServices.GetRequiredService<IActionContextAccessor>();
            var httpContextAccessor = helper.ViewContext.HttpContext.RequestServices.GetRequiredService<IHttpContextAccessor>();
            var actionSelector = serviceProvider.GetRequiredService<IActionSelector>();
 
            // creating new action invocation context
            var routeData = new RouteData();
            foreach (var router in helper.ViewContext.RouteData.Routers)
            {
                routeData.PushState(router, null, null);
            }
            routeData.PushState(null, new RouteValueDictionary(new { controller = controller, action = action, area = area }), null);
            routeData.PushState(null, new RouteValueDictionary(parameters ?? new { }), null);
 
            //get the actiondescriptor
            RouteContext routeContext = new RouteContext(helper.ViewContext.HttpContext) { RouteData = routeData };
            var candidates = actionSelector.SelectCandidates(routeContext);
            var actionDescriptor = actionSelector.SelectBestCandidate(routeContext, candidates);
 
            var originalActionContext = actionContextAccessor.ActionContext;
            var originalhttpContext = httpContextAccessor.HttpContext;
            try
            {
                var newHttpContext = serviceProvider.GetRequiredService<IHttpContextFactory>().Create(helper.ViewContext.HttpContext.Features);
                if (newHttpContext.Items.ContainsKey(typeof(IUrlHelper)))
                {
                    newHttpContext.Items.Remove(typeof(IUrlHelper));
                }
                newHttpContext.Response.Body = new MemoryStream();
                var actionContext = new ActionContext(newHttpContext, routeData, actionDescriptor);
                actionContextAccessor.ActionContext = actionContext;
                var invoker = serviceProvider.GetRequiredService<IActionInvokerFactory>().CreateInvoker(actionContext);
                await invoker.InvokeAsync();
                newHttpContext.Response.Body.Position = 0;
                using (var reader = new StreamReader(newHttpContext.Response.Body))
                {
                    return new HtmlString(reader.ReadToEnd());
                }
            }
            catch (Exception ex)
            {
                return new HtmlString(ex.Message);
            }
            finally
            {
                actionContextAccessor.ActionContext = originalActionContext;
                httpContextAccessor.HttpContext = originalhttpContext;
                if (helper.ViewContext.HttpContext.Items.ContainsKey(typeof(IUrlHelper)))
                {
                    helper.ViewContext.HttpContext.Items.Remove(typeof(IUrlHelper));
                }
            }
        }
    }
}

然后在Startup中的 ConfigureServices 方法添加：


services.AddSingleton<IHttpContextAccessor, HttpContextAccessor();
services.AddSingleton<IActionContextAccessor, ActionContextAccessor>();

这样就可以像NET Framework版本一样去调用子页面视图了：

@Html.Action("UserBackView", "UserManage")

12.过滤器

NET Framework版本

NET Framework版本上Global.asax中Application_Start方法可以做很多配置，过滤器也是其中一种。


protected void Application_Start()
{
    AreaRegistration.RegisterAllAreas();
    FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);//全局过滤器集合
    RouteConfig.RegisterRoutes(RouteTable.Routes);
    BundleConfig.RegisterBundles(BundleTable.Bundles);
}
 
public class FilterConfig
{
    public static void RegisterGlobalFilters(GlobalFilterCollection filters)
    {
        filters.Add(new HandleErrorAttribute());
        filters.Add(new LoginCheckFilterAttribute() { IsCheck = true });//自定义一个过滤器
    }
}
 
//继承过滤器基类并重写方法
public class LoginCheckFilterAttribute : ActionFilterAttribute
{
    //表示是否检查
    public bool IsCheck { get; set; }
    //Action方法执行之前执行此方法
    public override void OnActionExecuting(ActionExecutingContext filterContext)
    {
        base.OnActionExecuting(filterContext);
        if (IsCheck)
        {
            //添加自己的逻辑
        }
    }
}

NET Core版本：

NET Core不在支持Global.asax，很多配置写在Startup里。过滤器的添加方法如下：


public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc(options =>
    {
        options.Filters.Add(typeof(AuthorizationFilters));// 自定义一个类AuthorizationFilters，添加身份验证过滤器
    });
}
 
/// <summary>
/// 身份认证类继承IAuthorizationFilter接口
/// </summary>
public class AuthorizationFilters :IAuthorizationFilter
{
    /// <summary>
    ///  请求验证，当前验证部分不要抛出异常，ExceptionFilter不会处理
    /// </summary>
    /// <param name="context">请求内容信息</param>
    public void OnAuthorization(AuthorizationFilterContext context)
    {
        //写自己的逻辑
    }
}

13.使用session和解决sessionID一直变化的问题

NET Core版本：

在Startup类里添加session配置


public void ConfigureServices(IServiceCollection services)
{
    services.AddDistributedMemoryCache();
    services.AddSession(option =>
    {   //设置session过期时间
        option.IOTimeout = TimeSpan.FromHours(1);
        option.IdleTimeout = TimeSpan.FromHours(1);
    });
    services.AddMvc();
}
 
public void Configure(IApplicationBuilder app, IHostingEnvironment env, IServiceProvider svp)
{
    app.UseSession();//必须在app.UseMvc之前，否则报错
    app.UseMvc(routes =>
    {
        routes.MapRoute(
            name: "default",
            template: "{controller=Home}/{action=Index}/{id?}");
    });
}

配置完成后session就可以使用了，不过当Session保存有值，id才不会改变，没有值每次刷新都会变，可以给在使用session时可以给session随便赋个值以保证sessionid不会一直变化。


HttpContext.Session.Set("login", Encoding.UTF8.GetBytes("login"));
string sessionid = HttpContext.Session.Id;

14.MD5加密

NET Framework版本：


//参数str类型是string
System.Web.Security.FormsAuthentication.HashPasswordForStoringInConfigFile(str, "MD5");

NET Core版本：用以下这个方法替换了


/// <summary>
/// 32位MD5加密
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
private static string Md5Hash(string input)
{
	MD5CryptoServiceProvider md5Hasher = new MD5CryptoServiceProvider();
	byte[] data = md5Hasher.ComputeHash(Encoding.Default.GetBytes(input));
	StringBuilder sBuilder = new StringBuilder();
	for (int i = 0; i < data.Length; i++)
	{
	    sBuilder.Append(data[i].ToString("x2"));
	}
	return sBuilder.ToString();
}

15.Path.Combine()

该方法是路径拼接，在NET Framework版本和NET Core版本同样支持，不过用Path.Combine拼接出来的路径是这样的：xxxx\\xxxx,用的是“\\”，这种路径在Window系统上可以正常运行，但是在Linux上是无法定位到准确的路径的。Linux上的路径是这样的：xxxx/xxxx。所以当我们用Path.Combine这个方法时最好再配合一个替换方法：

Path.Combine(path1,path2).Replace("\\","/");

16.DateTime

donet core 2.1 DateTime.Now.ToString() 方法在不同平台返回的时间格式不一样，即使使用ToString("yyyy/MM/dd")希望转成'2019/04/18'这种格式，但在Centos7平台下它还是变成了‘2019-04-18’这样，可以考虑用Replace方法去替换。