如何升级 ASP.NET 项目 MySql.Data 和 Connector/NET 至 8.0.x

本教程教你如何升级 ASP.NET 项目中的 MySql.Data 和服务器安装的 Connector/NET 版本至 8.0.18。

使用 MySQL Application Configuration 升级 MySql.Data

双击打开 .edmx 文件后，解决方案资源管理器上会有 MySQL Application Configuration 的图标。（如果没有，点开“从数据库更新模型”一下即可）

勾选“Use MySQL with Entity Framework”，安装完成。

完成后发现，Nuget 中会自动安装或升级下面两个组件：

MySql.Data  8.0.18

MySql.Data.EntityFramework  8.0.18

并且在 Web.config 中会自动添加以下节点：

<system.data>
  <DbProviderFactories>
    <remove invariant="MySql.Data.MySqlClient" />
    <add name="MySQL Data Provider" invariant="MySql.Data.MySqlClient" description=".Net Framework Data Provider for MySQL" type="MySql.Data.MySqlClient.MySqlClientFactory, MySql.Data, Version=8.0.18, Culture=neutral, PublicKeyToken=c5687fc88969c44d" />
  </DbProviderFactories>
</system.data>

这段代码使 MySql.Data 8.0.18 的项目能够兼容运行在 Connector/NET 6.10.x 环境中。方便我们挨个升级服务器上的项目。

8.0.18 已经不再需要 MySql.Data.Entity 组件了，可以从 Nuget 中手动卸载。

Microsoft.Net.Compilers is only supported on MSBuild v16.3 and above

Microsoft.Net.Compilers is only supported on MSBuild v16.3 and above

解决办法：菜单 - 生成 - ASP.NET 编译 - 优化解决方案的生成性能

如果没有该项，在解决方案资源管理器中选中解决方案再试。

设置 TreatTinyAsBoolean 为 false 使 EF 映射 tinyint(1) 为 SByte 而非 bool

首先，在数据库连接字符串中添加：

TreatTinyAsBoolean=false

第二步，在项目中搜索该字段名，在搜索结果中找到 .edmx 文件中的两处。

.edmx 文件中的注释已经表明其包含 SSDL、CSDL、C-S mapping 三块内容，

在 SSDL content 下方找到该字段：

<Property Name="字段名" Type="bool" Nullable="***" />

改为

<Property Name="字段名" Type="tinyint" Nullable="***" />

在 CSDL content 下方找到该属性：

<Property Name="属性名" Type="Boolean" Nullable="***" />

改为

<Property Name="属性名" Type="SByte" Nullable="***" />

第三步，在解决方案管理器中展开 .edmx ->库名.tt -> 表名.cs 文件，

将模型类中的属性

public bool invisible { get; set; }

改为

public sbyte invisible { get; set; }

或 bool? 改为 sbyte?

完成。

参考：

https://mysqlconnector.net/connection-options/

https://stackoverflow.com/questions/6656511/treat-tiny-as-boolean-and-entity-framework-4

Discuz! X3.2 对审核内容的判断

与 2.X 不同的是，待审核的主题和回复是分开两张表存放的：

pre_forum_thread_moderate

pre_forum_post_moderate

字段 status 值含义：

0：未审核

1：已忽略

不在该表中的为已通过。

如何判断网页客户端是否为手机、是否在微信中打开等

* 若无特殊注明，本文中的“手机”包含平板电脑

判断网页是否在移动设备中打开

Web Form：

public static bool IsMobileDevice
{
    get
    {
        return (HttpContext.Current.Request.Browser?.IsMobileDevice ?? false)
            || (HttpContext.Current.Request.UserAgent?.Contains("Mobile") ?? false);
    }
}

ASP.NET Core：

好像还没有找到，可能是因为随着响应式布局的流行以及电脑和手机之间的界线越来越不明朗，取消了这个判断？

判断网页是否在微信浏览器中打开（宽松）

Web Form：

public bool IsInWechat
{
    get
    {
        return HttpContext.Current.Request.UserAgent?.Contains("MicroMessenger") ?? false;
    }
}

ASP.NET Core：

需注入 IHttpContextAccessor

public bool IsInWechat
{
    get
    {
        string ua = httpContextAccessor.HttpContext.Request.Headers[HeaderNames.UserAgent];
        return ua?.Contains("MicroMessenger") ?? false;
    }
}

判断网页是否在微信浏览器中打开（严谨）

使用 JS-SDK 网页授权来判断

ASP.NET Core 3.0 使用 X.PagedList.Mvc.Core 对列表进行分页

Nuget 安装：X.PagedList.Mvc.Core

控制器：

using X.PagedList;

public IActionResult Index(int page = 1)
{
    ……
    return View(q.ToPagedList(page, size));
}

视图：

@using X.PagedList
@using X.PagedList.Mvc.Core
@model IPagedList<xxx>

@Html.PagedListPager(Model, page => Url.Action("Index", new { page }))

自定义（options 默认值）：

@Html.PagedListPager(
    Model, 
    page => Url.Action("Index", new { page }), 
    new X.PagedList.Mvc.Common.PagedListRenderOptionsBase
    {
        HtmlEncoder = HtmlEncoder.get_Default(),
        DisplayLinkToFirstPage = PagedListDisplayMode.IfNeeded,
        DisplayLinkToLastPage = PagedListDisplayMode.IfNeeded,
        DisplayLinkToPreviousPage = PagedListDisplayMode.IfNeeded,
        DisplayLinkToNextPage = PagedListDisplayMode.IfNeeded,
        DisplayLinkToIndividualPages = true,
        DisplayPageCountAndCurrentLocation = false, // 显示总页数和当前页码
        MaximumPageNumbersToDisplay = 10, // 最多显示页码数
        DisplayEllipsesWhenNotShowingAllPageNumbers = true,
        EllipsesFormat = "…",
        LinkToFirstPageFormat = "<<",
        LinkToPreviousPageFormat = "<",
        LinkToIndividualPageFormat = "{0}",
        LinkToNextPageFormat = ">",
        LinkToLastPageFormat = ">>",
        PageCountAndCurrentLocationFormat = "Page {0} of {1}.",
        ItemSliceAndTotalFormat = "Showing items {0} through {1} of {2}.",
        FunctionToDisplayEachPageNumber = null,
        ClassToApplyToFirstListItemInPager = null,
        ClassToApplyToLastListItemInPager = null,
        ContainerDivClasses = new string[1]
        {
            "pagination-container"
        },
        UlElementClasses = new string[1]
        {
            "pagination"
        },
        LiElementClasses = Enumerable.Empty<string>(),
        PageClasses = Enumerable.Empty<string>(),
        UlElementattributes = null,
        ActiveLiElementClass = "active",
        EllipsesElementClass = "PagedList-ellipses",
        PreviousElementClass = "PagedList-skipToPrevious",
        NextElementClass = "PagedList-skipToNext",
    })

保留地址栏参数：

@{ 
    string query = Context.Request.QueryString.Value;
}
@Html.PagedListPager(Model, page => Regex.IsMatch(query, @"[?&]page=\d+")
    ? Regex.Replace(query, @"([?&])page=\d+", $"$1page={page}")
    : (query.StartsWith("?") ? $"{query}&page={page}" : $"{query}?page={page}"),
    new X.PagedList.Mvc.Common.PagedListRenderOptionsBase
    {
        DisplayPageCountAndCurrentLocation = true,
        MaximumPageNumbersToDisplay = 5,
    })

这里从查询字符串中判断并替换 page 值，如果有更简单的方法敬请告知。比如 Webdiyer 的分页组件会自动携带所有参数。

更多使用方式参官方文档：https://github.com/dncuug/X.PagedList

ASP.NET Core 3.0 对 CSS、JS、HTML 文件进行压缩、合并

安装 Nuget 包：

BuildBundlerMinifier

项目根目录创建绑定配置文件：bundleconfig.json

示例：

[
  {
    "outputFileName": "wwwroot/css/site.min.css",
    "inputFiles": [
      "wwwroot/css/site.css",
      "wwwroot/css/custom.css"
    ]
  },
  {
    "outputFileName": "wwwroot/js/site.min.js",
    "inputFiles": [
      "wwwroot/js/site.js"
    ],
    "minify": {
      "enabled": true,
      "renameLocals": true
    },
    "sourceMap": false
  }
]

配置文件中所有路径都相对于项目根目录（而非静态文件根目录 wwwroot），因此配置的路径都要以“wwwroot”开头。

outputFileName 是压缩合并后的文件，inputFiles 是被压缩合并的原始文件集合。

对于 js 配置部分，minify.enabled 配置是否缩小，renameLocals 配置是否修改变量名，sourceMap 配置是否生成 map 映射文件。

引用示例：

<link rel="stylesheet" href="~/css/site.min.css" asp-append-version="true" />

asp-append-version 表示是否在引用路径添加版本参数，可实现在文件有修改时及时在客户端浏览器中生效。

* 注意：有时候“生成”不一定生效，“重新生成”肯定会生效。

更多高级用法请参考官方文档。

ASP.NET Core 3.0 缓存（Cache）之 MySQL 缓存

ASP.NET Core 缓存 Caching 提供了包括但不限于以下几种存储方式：

内存缓存：https://xoyozo.net/Blog/Details/aspnetcore-memory-cache

SQL Server 缓存：https://xoyozo.net/Blog/Details/aspnetcore-sql-cache

Redis 缓存：https://xoyozo.net/Blog/Details/aspnetcore-redis-cache

MySQL 缓存：https://xoyozo.net/Blog/Details/aspnetcore-mysql-cache

Nuget 安装：Pomelo.Extensions.Caching.MySql

Nuget 安装：Pomelo.Extensions.Caching.MySqlConfig.Tools（用于在 MySql 数据库中创建表和索引以进行分布式缓存的命令行工具(dotnet-mysql-cache)）

由于 MySqlConfig.Tools 最新版本（2.0.2）不支持 .NetCore 3.0，暂时可手动创建表和索引。

未完待续，后续步骤类似于：https://xoyozo.net/Blog/Details/aspnetcore-sql-cache

services.AddDistributedMySqlCache()

ASP.NET Core 3.0 使用 Redis 保存会话状态（Session State）

按这两篇文章部署即可：

ASP.NET Core 缓存（Cache）之 Redis 缓存

ASP.NET Core 会话状态（Session State）

存储内容示例：

图中，

第 1 项为浏览器 A 中，在 Session 中设置键 count 值为 1 的结果；

第 2 项为浏览器 B 中，在 Session 中设置键 count 值为 3 的结果；

而第 3 项为设置 Cache 键 count 值为 8 的结果。

ASP.NET Core 3.0 使用 SQL Server 数据库保存会话状态（Session State）

按这两篇文章部署即可：

ASP.NET Core 缓存（Cache）之 SQL Server 缓存

ASP.NET Core 会话状态（Session State）

存储内容示例：

图中，

第 1 项为浏览器 A 中，在 Session 中设置键 count 值为 3 的结果；

第 3 项为浏览器 B 中，在 Session 中设置键 count 值为 1 的结果；

而第 2 项为设置 Cache 键 count 值为 5 的结果。