MySQL 连接器/NET 开发人员指南  /  第 2 章连接器/NET 版本

第 2 章连接器/NET 版本

本指南中描述了两个连接器/NET 版本系列：

  • MySQL Connector/NET 8.0 是 Connector/NET 7.0 的延续，但现在命名为将版本号的第一位与其支持的（最高）MySQL 服务器版本同步。此版本结合了以前的 Connector/NET 发布系列的功能，包括对 X 协议连接的支持。Connector/NET 自定义 Entity Framework Core 以处理 MySQL 数据，在 .NET 驱动程序实现中启用压缩，并将跨平台支持扩展到 Linux 和 macOS。

    强烈建议将 MySQL Connector/NET 8.0 与 MySQL Server 8.0 一起使用。

  • MySQL Connector/NET 6.10 已停止服务。

使用 TLSv1.2 协议的安全连接需要 Connector/NET 8.0.11 或更高版本。此外，您的 Microsoft Windows 主机必须启用 TLSv1.2 协议。使用 Windows 命名管道或共享内存建立的连接不支持 TLSv1.2 协议。有关为安全连接配置服务器和客户端的一般指南，请参阅配置 MySQL 以使用加密连接。

笔记

.NET 7、.NET 6、.NET 5、.NET Core 3.1 和 .NET Framework 4.8（仅限 Windows）包括对 TLSv1.3 协议的支持。在专门用于连接之前，请务必确认运行您的应用程序的操作系统也支持 TLSv1.3。

下表显示了 MySQL 连接器/NET 支持或需要的 ADO.NET、.NET（核心和框架）和 MySQL 服务器的版本。对于 Connector/NET 面向的特定实体框架版本，请参阅第 7 章，实体框架的连接器/NET。

表 2.1 相关产品的连接器/NET 要求

连接器/网络版本 ADO.NET版本 需要 .NET 版本 MySQL服务器 支持的？
8.0 2.x+

  • C/NET 8.0.31+：VS 2022 的 .NET 7 预览版（V17.4 或更高版本）；.NET 6 for VS 2022 (v17.0) 和 VS 2022 for Mac（v17.0 预览版）；.NET 5 for VS 2019 (v16.8) 和 VS 2019 for Mac (v8.8)；.NET Core 3.1 for VS 2019（版本 16.4 或更高版本）；适用于 VS 2019 的 .NET Framework 4.8（版本 16.3 或更高版本）

  • C/NET 8.0.28+：适用于 VS 2022（v17.0 或更高版本）的 .NET 6 和适用于 Mac（v8.10）的 VS 2019；.NET 5 for VS 2019 (v16.8) 和 VS 2019 for Mac (v8.8)；.NET Core 3.1 for VS 2019（版本 16.4 或更高版本）；适用于 VS 2019 的 .NET Framework 4.8（版本 16.3 或更高版本）

  • C/NET 8.0.23+：.NET 5 for VS 2019 (v16.8) 和 VS 2019 for Mac (v8.8)；.NET Core 3.1 for VS 2019（版本 16.4 或更高版本）；适用于 VS 2019 的 .NET Framework 4.8（版本 16.3 或更高版本）

  • C/NET 8.0.22+：.NET 5 for VS 2019 (v16.7) 和 VS 2019 for Mac (v8.7)；.NET Core 3.1 for VS 2019（版本 16.4 或更高版本）；适用于 VS 2019 的 .NET Framework 4.8（版本 16.3 或更高版本）

  • C/NET 8.0.20+：适用于 VS 2019 的 .NET Core 3.1（版本 16.4 或更高版本）；适用于 VS 2019 的 .NET Framework 4.8（版本 16.3 或更高版本）

  • C/NET 8.0.19+：适用于 VS 2019 的 .NET Core 3.0（版本 16.3 或更高版本）；适用于 VS 2019 的 .NET Framework 4.8（版本 16.3 或更高版本）

  • C/NET 8.0.18+：适用于 VS 2019 的 .NET Core 3.0（版本 16.3 或更高版本）

  • C/NET 8.0.17+：.NET Core 2.2 for VS 2017（版本 15.0.9 或更高版本），.NET Core 2.1 for VS 2017（版本 15.0.7 或更高版本）

  • C/NET 8.0.10+：适用于 VS 2017 的 .NET Core 2.0（版本 15.0.3 或更高版本）

  • C/NET 8.0.8+：适用于 VS 2013 / 2015 / 2017 的 .NET Framework 4.5.x

8.0 和 5.7 是的
6.10存档版本 2.x+

  • C/NET 6.10.9+：.NET Core 2.2 for VS 2017（版本 15.0.9 或更高版本），.NET Core 2.1 for VS 2017（版本 15.0.7 或更高版本）

  • C/NET 6.10.5+：适用于 VS 2017 的 .NET Core 2.0（版本 15.0.3 或更高版本）

8.0, 5.7, 5.6 升级到 8.0

不再支持以下版本的连接器/NET：

  • MySQL Connector/NET 7.0 包括对 X 协议的支持（仅限开发里程碑版本）。

  • MySQL Connector/NET 6.9 包括新功能，例如 MySQL Web 个性化、站点地图和简单的成员资格提供程序。它还包括对 MySQL for Visual Studio 1.2（或更高版本）的支持。

  • Connector/NET 6.8 包括新功能，例如 Entity Framework 6 支持、为 Entity Framework 6 迁移添加幂等脚本、更改 EF 迁移历史表以使用单个列作为主键、在安装 MySQL for Visual Studio 时删除安装程序验证，以及支持用于 Visual Studio 1.1 的 MySQL。

    不再支持此版本的连接器/NET。

  • Connector/NET 6.7 包括新功能，例如 Entity Framework 5 支持、内置负载平衡（与实现 MySQL 复制或 MySQL 集群的后端一起使用）、Memcached 客户端（与 Innodb Memcached 插件兼容）和对 Windows 的支持用于编写商店应用程序的运行时 (WinRT)。此版本还删除了与 Visual Studio 集成相关的所有功能，这些功能在单独的产品 MySQL for Visual Studio中提供。

    不再支持此版本的连接器/NET。

  • Connector/NET 6.6 包括一些新功能，例如 Microsoft Visual Studio 中的存储过程调试、对可插入身份验证的支持（包括编写您自己的身份验证插件的能力）、Entity Framework 4.3 Code First 支持以及对部分信任支持的增强以允许部署托管服务应用程序无需在 GAC 中安装 Connector/NET 库。

    不再支持此版本的连接器/NET。

  • Connector/NET 6.5 包括新功能，例如异常和命令的拦截器类、对 MySQL 5.6+ 小数秒功能的支持、更好的部分信任支持和更好的 IntelliSense，包括编辑存储过程或.mysql文件时的自动完成。

    不再支持此版本的连接器/NET。

  • Connector/NET 6.4 包括一些新功能，例如支持 Windows 身份验证（当连接到 MySQL Server 5.5+ 时）、客户端的表缓存、简单的连接故障转移支持以及来自 Entity Framework 提供程序的改进的 SQL 生成。

    不再支持此版本的连接器/NET。

  • Connector/NET 6.3 包括新功能，例如与 Visual Studio 2010 的集成，例如实体框架的 DDL T4 模板的可用性，以及自定义 MySQL SQL 编辑器。其他功能包括重构的事务范围：Connector/NET 现在支持在使用相同连接字符串的范围内嵌套事务。

    不再支持此版本的连接器/NET。

  • Connector/NET 6.2 包括新功能，例如新的日志系统和客户端 SSL 证书。

    不再支持此版本的连接器/NET。

  • Connector/NET 6.1 包括新功能，例如 MySQL Website Configuration Tool 和 Session State Provider。

    不再支持此版本的连接器/NET。

  • Connector/NET 6.0 包括对 UDF 模式集合、初始实体框架的支持，以及在 Visual Studio 中使用传统 SQL Server 按钮进行键、索引等。

    不再支持此版本的连接器/NET。

  • Connector/NET 5.2 包括对新成员和角色提供程序的支持、Compact Framework 2.0、新的存储过程解析器和对GetSchema. Connector/NET 5.2 还包括 Visual Studio 插件作为标准可安装组件。

    不再支持此版本的连接器/NET。

  • Connector/NET 5.1 包括对新成员和角色提供程序的支持、Compact Framework 2.0、新的存储过程解析器和对GetSchema. Connector/NET 5.1 还包括作为标准可安装组件的 Visual Studio 插件。

    不再支持此版本的连接器/NET。

  • Connector/NET 5.0 包括对 ADO.NET 2.0 接口和子类的完全支持，包括对使用顾问和性能监视器 (PerfMon) 挂钩的支持。

    不再支持此版本的连接器/NET。

  • Connector/NET 1.0 包括与 ADO.NET 驱动程序接口的完全兼容性。

    不再支持此版本的连接器/NET。

下表显示了所需的 .NET Framework 版本和 Connector/NET 支持的 MySQL 服务器版本：

表 2.2 相关产品的连接器/NET 要求

连接器/网络版本 支持的 ADO.NET 版本 需要 .NET Framework 版本 支持的 MySQL 服务器版本 目前支持
7.0 2.x+ .NET Core 1.1 适用于 VS 2015 / 2017；适用于 VS 2013 / 2015 / 2017 的 .NET Framework 4.5.x 5.7, 5.6 不
6.9 2.x+ VS 2008 3.5+，VS 2010/2012/2013 4.x+，VS 2012/2013 WinRT 5.7, 5.6, 5.5 不
6.8 2.x+ VS 2008 3.5+，VS 2010/2012/2013 4.x+，VS 2012/2013 WinRT 5.7、5.6、5.5、5.1、5.0 不
6.7 2.x+ 2.x+ 用于 VS 2008，4.x+ 用于 VS 2010 / 2012 / 2013，WinRT 用于 VS 2012 / 2013 5.7、5.6、5.5、5.1、5.0 不
6.6 2.x+ VS 2008 为 2.x+，VS 2010 / 2012 / 2013 为 4.x+ 5.7、5.6、5.5、5.1、5.0 不
6.5 2.x+ VS 2008 为 2.x+，VS 2010 为 4.x+ 5.7、5.6、5.5、5.1、5.0 不
6.4 2.x+ 2.x+、4.x+ 适用于 VS 2010 5.6、5.5、5.1、5.0 不
6.3 2.x+ 2.x+、4.x+ 适用于 VS 2010 5.6、5.5、5.1、5.0 不
6.2 2.x+ 2.x+ 5.6、5.5、5.1、5.0、4.1 不
6.1 2.x+ 2.x+ 5.6、5.5、5.1、5.0、4.1 不
6.0 2.x+ 2.x+ 5.5、5.1、5.0、4.1 不
5.2 2.x+ 2.x+ 5.5、5.1、5.0、4.1 不
5.1 2.x+ 2.x+ 5.5、5.1、5.0、4.1、4.0 不
5.0 2.x+ 2.x+ 5.0、4.1、4.0 不
1.0 1.x 1.x 5.0、4.1、4.0 不