Using MySQL

One of the updates in MicroLite 3.0 was support for MySQL, however there are a couple of things you need to do if you wish to use MySQL which you don’t for MS SQL. This is due to the fact that the .NET framework supports MS SQL natively, whereas the MySQL implementations of the System.Data classes are provided by

The easiest way to get started is to install the MySQL.Data NuGet package, although you can download and install it from if you don’t/can’t use NuGet.

As usual you will still need to add a named connection string to your app.config:

    <add name="MySQLTest"
         providerName="MySql.Data.MySqlClient" />

You also need to add another section to your app.config so that the .NET framework knows about the MySql.Data provider:

        <remove invariant="MySql.Data.MySqlClient" />
        <add name="MySQL Data Provider"
             description="ADO.Net driver for MySQL"
             type="MySql.Data.MySqlClient.MySqlClientFactory, MySql.Data, Version=, Culture=neutral, PublicKeyToken=c5687fc88969c44d" />

Make sure that the version specified matches the version you have installed or you will get an exception thrown by the .NET runtime at startup when it tries to resolve the assembly.

Then finally, in you application startup, you need to call the overload method for ForConnection so that you can specify the MySqlDialect:

var sessionFactory = Configure
    .ForConnection(connectionName: "MySQLTest", sqlDialect: "MicroLite.Dialect.MySqlDialect")

This article was written for version 3.0.0 of the MicroLite framework.


As of MicroLite 4.0.1, use the ForMySqlConnection method instead:

var sessionFactory = Configure

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s