MySQL Connector/NET работает на любой платформе, которая поддерживает .NET Standard (.NET Framework, .NET Core и Mono). .NET Framework прежде всего, поддерживается на последних версиях Microsoft Windows и Microsoft Windows Server.
Кросс-платформенные варианты:
.NET Core работает в Windows, macOS и Linux.
Open Source Mono platform работает в Linux.
Connector/NET доступен для скачивания с MySQL Installer, как standalone MSI Installer или из NuGet gallery. Исходный текст доступен с MySQL Download MySQL Connector/NET или с GitHub MySQL Connector/NET repository.
В Microsoft Windows можно установить посредством двоичного процесса установки, используя Connector/NET MSI, выбрать продукт MySQL Connector/NET в MySQL Installer, используя NuGet, или скачать и собрать исходные тексты.
Перед установкой гарантируйте, что ваша система актуальна, включая установку последней версии .NET Framework или .NET Core. См. раздел 2.
MySQL Installer обеспечивает простой в использовании, основанный на мастере, инсталляционный путь для всего программного обеспечения MySQL в Windows. Это может использоваться, чтобы установить и модернизировать вашу установку MySQL Connector/NET.
Чтобы использовать, загрузите и установите MySQL Installer.
После выполнения MySQL Installer, выберите и установите продукт Connector/NET.
Можно установить MySQL Connector/NET через Windows Installer
(.msi
), который может установить
Connector/NET на поддержанных операционных системах Windows. Пакет это файл
с именем mysql-connector-net-
, где
version
.msiversion
указывает
версию Connector/NET.
Использование центрального MySQL Installer рекомендуется вместо автономного пакета, который здесь описан. MySQL Installer доступен для скачивания с MySQL Installer.
Для установки Connector/NET:
Сделайте двойной клик по файлу MSI installer, кликните по
, чтобы начать установку.Выберите тип установки (Typical, Custom или Complete), затем кликните по
Типовая установка подходит в большинстве случаев. Нажмите
и продолжите двигаться к шагу 5.Полная установка устанавливает все доступные файлы. Чтобы провести полную установку, нажмите кнопку
и перейите к шагу 5.Чтобы настроить вашу установку, включая выбор компонентов, чтобы установить, и некоторые опции инсталляции, нажмите
и перейдите к шагу 3.Инсталлятор Connector/NET зарегистрирует соединитель в Global Assembly Cache (GAC), это сделает компонент Connector/NET доступным для всех приложений, а не только тех, где вы явно ссылаетесь на компонент Connector/NET. Инсталлятор также создаст необходимые связи в меню Start к документации и информации о версии.
Если вы выбрали пользовательскую установку, можно выбрать отдельные компоненты, чтобы установить, включая основной интерфейсный компонент, варианты сопроводительной документации, примеры и исходный код. Нажмите
, чтобы определить требования к пространству на диске вашего выбора.Выберите пункты и их инсталляционный уровень и затем кликните
, чтобы продолжить установку.Вам дадут заключительную возможность подтвердить установку. Нажмите
, чтобы скопировать и установить файлы на ваш компьютер. Используйте , чтобы вернуться к изменению составляющих вариантов.Когда надо нажмите
, чтобы выйти из инсталлятора MSI.Если вы не выбираете иной каталог, Connector/NET установится в
C:\Program Files (x86)\MySQL\MySQL Connector Net
(версия установки).
Новые установки не переписывают существующие версии Connector/NET.version
Можно также использовать параметр командной строки
/quiet
или /q
инструмента msiexec
, чтобы установить пакет
Connector/NET автоматически (используя опции по умолчанию) без уведомления
пользователю. Используя этот метод, пользователь не может выбрать другие
варианты. Кроме того, сообщения или диалоговые окна не будут показаны.
C:\> msiexec /package connector-net.msi /quiet
Чтобы предоставить индикатор выполнения пользователю во время
автоматической установки, используйте опцию
/passive
.
MySQL Connector/NET доступен как пакеты от NuGet, диспетчера пакетов с открытым исходным кодом для платформы разработки Microsoft (включая .NET Core). NuGet Gallery это центральное хранилище пакетов программного обеспечения с новыми пакетами NuGet для Connector/NET.
Можно установить или модернизировать один или несколько отдельных пакетов Connector/NET через NuGet, делая удобным способом ввод существующей технологии, такой как Entity Framework. NuGet управляет зависимостями через связанные пакеты, и все предпосылки перечисляются в галерее NuGet. Для описания каждого пакета Connector/NET см. Connector/NET Packages (NuGet).
Для проектов, которые требуют, чтобы сборки Connector/NET были сохранены в GAC, интеграции с Entity Framework Designer (Visual Studio) или доступа к MySQL for Visual Studio, используйте MySQL Installer или standalone MSI для установки Connector/NET вместо того, чтобы установить пакеты NuGet.
NuGet Gallery ( https://www.nuget.org/) обеспечивает несколько инструментов клиента, которые могут помочь вам установить или модернизировать пакеты Connector/NET. Если вы не знакомы с вариантами инструмента или процессами, посмотрите Package consumption workflow. После получения описания пакета в NuGet подтвердите следующую информацию:
Идентичность и номер версии пакета правильны. Используйте список Version History, чтобы выбрать текущую версию.
Все предпосылки устанавливаются. См. список Dependencies.
Условия лицензионного соглашения приемлемы. См. ссылку License Info.
Connector/NET обеспечивает следующие пять пакетов NuGet:
MySql.Data
Этот пакет содержит базовую функциональность Connector/NET, включая использование MySQL как хранилище документов (только с Connector/NET 8.0). Это осуществляет необходимые интерфейсы ADO.NET и объединяется с инструментами ADO.NET. Кроме того, пакеты обеспечивают доступ к многим версиям сервера MySQL и заключают в капсулу определенные для базы данных протоколы.
MySql.Web
Пакет MySql.Web
включает поддержку модели поставщика ASP.NET 2.0 (см.
раздел 5.16).
Эта модель позволяет вам сосредоточиться на бизнес-логике вашего приложения
вместо того, чтобы воссоздавать шаблонные пункты, такие как ролевая поддержка
и членство. Пакет поддерживает членство, роль, профиль и
поставщиков состояния сеанса.
Зависит от: MySql.Data
.
MySql.Data.EntityFramework
Этот пакет обеспечивает возможности object-relational mapper (ORM), что позволяет вам работать с базами данных MySQL, используя проблемно-ориентированные объекты, таким образом избавляя от необходимости писать большую часть доступа к данным. Выберите этот пакет для своих приложений Entity Framework 6 (см. раздел 7.1).
Зависит от: MySql.Data
.
MySql.Data.EntityFrameworkCore
Этот пакет подобен
MySql.Data.EntityFramework
, но
это обеспечивает поддержку разных платформ для задач Entity Framework.
Выберите этот пакет для своих приложений Entity Framework Core (см.
раздел 7.2).
MySql.Data.EntityFrameworkCore.Design
Пакет MySql.Data.EntityFrameworkCore.Design
включает разделенные компоненты времени проектирования для
инструментов Entity Framework Core, которые мигрируют базы данных MySQL.
Начиная с Connector/NET 8.0.20, функциональность, обеспеченная в этом
пакете, была перемещена в
MySql.Data.EntityFrameworkCore
. Оригинальный
MySql.Data.EntityFrameworkCore.Design
устарел.
Нет никакого инсталлятора, доступного для установки компонента MySQL Connector/NET в Unix. Перед установкой гарантируйте, чтобы у вас была рабочая установка проекта Mono. Чтобы проверить, имеет ли ваша система установленный Mono:
shell> mono --version
Версия Моно JIT-компилятора показана.
Чтобы собрать исходный код C#, удостоверьтесь, что компилятор Mono C# установлен.
Есть три доступные компилятора Mono C#:
mcs
, который получает доступ к библиотекам с
профилями 1.0, gmcs
,
который получает доступ к библиотекам с профилями 2.0, и
dmcs
, который получает
доступ к библиотекам с профилями 4.0.
Чтобы установить Connector/NET в Unix/Mono:
Скачайте mysql-connector-net-
и извлеките содержание в каталог по усмотрению, например, в
version
-noinstall.zip~/connector-net/
.
В этом каталоге перейдите в подкаталог
bin
. Гарантируйте, что есть файл
MySql.Data.dll
.
Это имя файла чувствительное к регистру.
Необходимо зарегистрировать компонент Connector/NET,
MySql.Data
, в Global Assembly Cache (GAC).
В текущем каталоге введите gacutil
:
root-shell> gacutil /i MySql.Data.dll
Это зарегистрирует MySql.Data
в GAC.
Можно проверить это, перечислив содержание
/usr/lib/mono/gac
, где вы найдете
MySql.Data
, если регистрация была успешна.
Вы теперь готовы собрать свое приложение.
Необходимо гарантировать, чтобы, когда вы собираете свое приложение, вы
включали компонент Connector/NET с использованием опции
-r:
:
shell> gmcs -r:System.dll -r:System.Data.dll -r:MySql.Data.dll \ HelloWorld.cs
Сборки, на которые ссылаются, зависят от требований применения, но
приложения Connector/NET должны обеспечить хотя бы
-r:MySql.Data
.
Можно далее проверить установку, запустив собранную программу, например:
shell> mono HelloWorld.exe
Сборка MySQL Connector/NET из исходных текстов позволяет настроить параметры и целевые платформы, такие как Linux и macOS. Процедуры в этой секции описывают, как собрать с Microsoft Visual Studio (Windows или macOS) и .NET Core CLI (Windows, macOS или Linux).
Исходный текст MySQL Connector/NET доступен на
https://dev.mysql.com/downloads/connector/net/. Выберите
Source Code
из списка
Select Operating System. Используйте вкладку
Archive, чтобы загрузить предыдущую версию
исходного кода Connector/NET.
Исходный код упакован как архивный файл ZIP с именем, подобным
to mysql-connector-net-8.0.19-src.zip
.
Распакуйте архив в локальный каталог.
Файл включает следующие каталоги:
EFCore
:
Исходные тексты и испытательные файлы для Entity Framework Core.
EntityFramework
:
Исходные тексты и испытательные файлы для Entity Framework 6.
MySQL.Data
:
Исходные тексты и испытательные файлы для MySQL library.
MySQL.Web
:
Исходные тексты и испытательные файлы для веб-поставщиков, включая членство,
роль, профили поставщиков, которые используются на веб-сайтах ASP.NET или
ASP.NET Core.
Следующая процедура может использоваться, чтобы построить соединитель в Microsoft Windows или macOS. Connector/NET поддерживает различные версии Microsoft Visual Studio и библиотек .NET. Для руководства о версии Connector/NET, которую вы намереваетесь собрать, см. главу 2.
Перейдите в каталог исходного кода и затем в подкаталог
с исходными файлами, например, MySql.Data
.
Каждый исходный каталог содержит файл решения
.sln
для Microsoft Visual Studio
(например, MySqlData.sln
).
Дважды щелкните по файлу решений, чтобы запустить Visual Studio и открыть решение.
Visual Studio открывает файлы решения в Solution Explorer. Все проекты, связанные с решением, также появляются в дереве навигации. Эти связанные проекты могут включать испытательные файлы и проекты, которых требуют ваши решения.
Определите местонахождение проекта с тем же самым именем как решение
(в этом примере MySql.Data
).
Щелкните правой кнопкой мыши по узлу и выберите из контекстного меню
, чтобы построить решение.
Следующая процедура может использоваться, чтобы построить соединитель в
Microsoft Windows, Linux или macOS. Текущая версия .NET Core SDK
должна быть установлена локально, чтобы выполнить команду
dotnet
. Для получения дополнительной информации
об использовании посетите
https://docs.microsoft.com/en-us/dotnet/core/tools/.
Откройте терминал, например,
PowerShell
,
Command Prompt
или
bash
.
Перейдите к корню каталога исходного кода и затем в подкаталог с исходными
файлами, например, MySQL.Data
.
Уберите вывод предыдущей сборки.
dotnet clean
Введите следующую команду, чтобы построить файл решения
(в этом примере MySql.Data.sln
) с
использованием аргументов команды по умолчанию:
dotnet build
Решение и умолчание проекта. Когда никакой каталог и имя файла не
предоставлены в командной строке, значение по умолчанию зависит от текущего
каталога. Если команда выполняется из главного каталога, например,
MySQL.Data
, файл решения выбран
selected (с .NET Core 3.0 SDK). Иначе, если выполнено из подкаталога
src
, используется файл проекта.
Умолчание конфигурации, -c
|
--configuration
. Умолчания для сборки
Debug
. Альтернативно,
-c Release
это иное
поддержанное значение аргумента конфигурации сборки.
Умолчание Framework, -f
|
--framework
.
Когда никакая структура не определяется в командной строке, решение или
проект строятся для всех возможных структур, которые применяются.
Чтобы определить, какие структуры поддерживаются, используйте текстовый
редактор, чтобы открыть связанный файл проекта (например,
MySql.Data.csproj
в подкаталоге
src
) и поиска элементов
<TargetFrameworks>
.
Чтобы построить исходный код в Linux и macOS, необходимо задать цель
.NET Standard (-f netstandard2.0
или
-f netstandard2.1
).
Чтобы построить исходный код в Microsoft Windows, необходимо задать цель
.NET Standard и .NET Framework (-f net452
или
-f net48
).