Installation

In This Topic

dotConnect for MySQL is provided as a single setup package that contains all required files for Full .NET Framework and documentation.

By default dotConnect for MySQL installs all files in "Program Files\Devart\dotConnect\MySQL" folder. The setup program also adds the necessary assemblies to the Global Assembly Cache by default. You can omit adding assemblies to GAC by selecting the Do not install assemblies in the GAC check box on the Additional Tasks installation wizard page. To install only *.dll files needed to run applications that use dotConnect for MySQL, you can select "Minimal" install in the setup program.

Please note that the installer contains and installs only the dotConnect for MySQL assemblies for full .NET Framework. dotConnect for MySQL .NET Standard compatible assemblies are available only via the NuGet packages. However, if you want to use .NET Standard compatible assemblies on a trial basis, you will still need to install the installer to obtain the trial license key files.

Some files are shared by Devart data providers. These assemblies are copied to the "\Program Files\Common Files\Devart\dotConnect\5.00\Net2\" folder. If you have several Devart data providers, make sure they use same version of the Devart.Data.dll assembly.

There are some limitations in Express Editions of Visual Studio. Particularly, the automatic toolbox components registration and Server Explorer integration are not available. You can, however, install components into toolbox manually as described below. As an exclusion, Visual Web Developer supports Server Explorer integration features.

Command Line Installation Keys

dotConnect for MySQL installer is created with Inno Setup. Its standard setup command line parameters article is available at http://www.jrsoftware.org/ishelp/topic_setupcmdline.htm.

Also there are additional installation keys:

/nomachineconfig - no provider factory registration in DbProviderFactories section of machine.config.
/verysilent and /silent - besides standard Inno Setup functionality, no FAQ page is shown after installation is finished.
/nofeedback - no Feedback page is opened after uninstall.
/nomergepackage - not install menu item and toolbox components into Visual Studio.
/mergehelp - merge Devart documentation to MS Help collection.
/disablegac - omit adding assemblies to GAC.

Example:

the minimal type installation (only run-time assemblies and registration in machine.config)
```
 dcmysql.exe /TYPE=COMPACT /VERYSILENT /NOICONS
```

uninstall

\Program Files\Devart\dotConnect\MySQL\Uninstall\unins000.exe /VERYSILENT /NOFEEDBACK

The following table contains the list of components, that can be used with the /COMPONENTS key.

Component name	Parameter
Visual Studio integration *	VsIntegration
Support for ADO.NET Entity Framework	Entity
LINQ	LinqRuntime
Entity Developer	ModelerTool
ASP.NET Web Providers	WebProviders
ASP.NET Identity	AspNetIdentity
SQL Server Business Intelligence Solutions	SSIS
Workflow Instance Store	WFInstanceStore
Enterprise Library Data Access Block	EntLib
Sync Framework Support	SyncFramework
Samples	Samples
Help files	HelpFiles

* You may use the "*VsIntegration" parameter (with asterisk) to integrate the provider to all the installed Visual Studio versions, which are supported by dotConnect for MySQL. To install it only to Visual Studio 2010, for example, use "VsIntegration\VS2010" parameter.

Microsoft Visual Studio

dotConnect for MySQL components are automatically registered in Toolbox when you start the Visual Studio first time after successful installation of dotConnect for MySQL. If automatic registration fails, do the following steps to install the components manually:

In Visual Studio open the Toolbox window;
Add a 'MySQL Data' tab by right-clicking the Toolbox window and then clicking Add Tab;
Right-click the added tab and then click Choose Items...;
In the opened Choose Toolbox Items dialog box switch to the .NET Framework Components tab;;
Select the components the Namespace column of which starts with "Devart";
Click OK.

Since now dotConnect for MySQL components are available from toolbox.

In Visual Studio Code you can use only dotConnect for MySQL installed as NuGet packages. Since Visual Studio Code lacks design-time support, no design-time, advanced integration, dotConnect for MySQL tools or wizards are available in it.

CodeGear Delphi 2007

Because of the IDE restrictions design time is not available.

[email protected]