De namespace MercatorApi die zich bevindt in de assembly MercatorTunnel.dll bevat de klasse MercatorSqlConnection, die het mogelijk maken om heel eenvoudig een verbinding op te stellen naar de SQL-server. Om deze klasse te kunnen gebruiken in C# volstaat het om een reference toe te voegen naar MercatorTunnel.dll en vervolgens moet men "using MercatorApi;" toevoegen bovenaan in de code.
Gebruik van MercatorSqlConnection
Deze klasse bevat 2 publieke eigenschappen (alleen-lezen):
- Connection: SqlConnection met de SQL-databank van Mercator
- LastError: string met een tekenreeks die de laatste foutmelding aangeeft.
De constructeur van deze klasse vereist slechts 1 parameter van het type string: de Data-directory van Mercator (daar vindt u de verbindingsklasse, alsook alle parameters die nodig zijn om de verbinding te maken). De constructeur van deze klasse voert het commando Open() uit op de SqlConnection van System.Data.SqlClient.
Voorbeeldcode
using (MercatorSqlConnection conn = new MercatorSqlConnection(MercatorUi.Globals.RepData, true))
{
if (!conn.IsConnected)
return;
using (MercatiorSqlCommand cmd = new MercatorSqlCommand("update...", conn))
{
...
}
}
💡 Mercator raadt aan deze pattern te gebruiken en niet rechtstreeks SqlConnection en SqlCommand, omdat dit het mogelijk maakt agnostisch te blijven tussen System.Data.SqlClient (.NET 4.8 tot .NET 8.0) en Microsoft.Data.SqlClient (.NET 10.0 of later).