【备忘】ASP.NET MVC 5 升级到 ASP.NET Core MVC 的部分变化

时间:2022-11-28 08:52:57

正在将一个 .net 4.5 的项目(MVC 5)升级到 .net core 2.1,中间遇到了许多的修改,记在下面,帮大家少走弯路。

  1. System.Drawing 下面很多类已经不存在(如Bitmap),可以下载扩展包,例如:https://github.com/zkweb-framework/ZKWeb.System.Drawing,或:https://www.nuget.org/packages/System.Drawing.Common/
  2. Controller 中已经没有 OnResultXX() 的重写方法,解决方法:让 Controller 实现 IResultFilter 接口即可
  3. RouteData.GetRequiredString("controller") 方法已经不被支持,可以使用 RouteData.Values["controller"].ToString() 方法来取代
  4. Cookie 的写入方法如:
     Response.Cookies.Append("SMS", "", new CookieOptions()
    {
    Expires = DateTime.Now.AddMinutes()
    });
  5. 例如 OnResultExecuting(ResultExecutingContext filterContext) 中的 filterContext.Controller 已经改为 object 类型,如果你确定使用的是默认的 Controller 的话,可以这样写:
    (filterContext.Controller as Controller).ViewData
  6. Controller 中的 Session["xx"] 访问方式改为 HttpContext.Session.GetString("xx")
  7. MvcHtmlString 变为 HtmlString,接口为 IHtmlContent
  8. [ValidateInput(false)] 标签已经不再需要添加:https://github.com/aspnet/Mvc/issues/324
  9. Response.ClearContent(); 已经不能使用, Response.BinaryWrite() 方法改为 Response.Body.Write()
  10. new UrlHelper(helper.ViewContext.RequestContext) 改为 new UrlHelper(helper.ViewContext)
  11. Request.UserHostName 改为 Request.Host.Value
  12. Request.Url.Host 改为 Request.Host,注意:通常会包含端口号,或使用:httpContext.Connection.RemoteIpAddress
  13. Request.UserHostAddress 改为 httpContext.Features.Get<IHttpConnectionFeature>()?.RemoteIpAddress
  14. HttpUnauthorizedResult 改名为 UnauthorizedResult
  15. Controller 的 OnAuthentication() 重写方法已经没有了
  16. HtmlHelper.AttributeEncode() 方法已失效
  17. Request..HttpMethod 改为 Request.Method
  18. Request.IsSecureConnection 可以使用 Request.IsHttps
  19. Request.Url.PathAndQuery 改为 Request.Path + Request.Query,可以自己写一个扩展方法进行封装
  20. Request.UrlReferrer 已经不被支持,可以自己封装:request.Headers["Referer"].ToString()
  21. Request.UserAgent 已经不被支持,可以自己封装:request.Headers["User-Agent"].ToString()
  22. Request.IsAjaxRequest 方法在.net core 中没有支持,可以自行扩展:
        /// <summary>
/// Determines whether the specified HTTP request is an AJAX request.
/// </summary>
///
/// <returns>
/// true if the specified HTTP request is an AJAX request; otherwise, false.
/// </returns>
/// <param name="request">The HTTP request.</param><exception cref="T:System.ArgumentNullException">The <paramref name="request"/> parameter is null (Nothing in Visual Basic).</exception>
public static bool IsAjaxRequest(this HttpRequest request)
{
if (request == null)
throw new ArgumentNullException("request"); if (request.Headers != null)
return request.Headers["X-Requested-With"] == "XMLHttpRequest";
return false;
}
}

注意:命名空间多数都会有变化,根据IDE提示添加即可。