L'espace de noms MercatorApi contenu dans l'assembly MercatorTunnel.dll contient deux classes, MercatorSqlConnection et MercatorDbConnection, permettant d'effectuer très simplement une connexion vers le serveur SQL. Pour pouvoir utiliser ces classes dans un code en C#, il suffit donc d'ajouter une référence vers MercatorTunnel.dll et ensuite d'indiquer la clause "using MercatorApi" dans l'entête du code.
Utilisation de MercatorSqlConnection (basé sur System.Data.SqlClient)
Cette classe contient 2 propriétés publiques en lecture-seule :
- Connection : SqlConnection sur la database SQL de Mercator
- LastError : string contenant une chaîne de caractères indiquant le dernier message d'erreur
Le constructeur de cette classe requiert seulement 1 paramètre de type string : le répertoire des données de Mercator. (La classe de connexion y trouve ainsi tous les paramètres nécessaires pour établir la connexion). Le constructeur de cette classe effectue la commande Open() sur le SqlConnection de System.Data.SqlClient.
Exemple de code :
using (MercatorSqlConnection dbConn = new MercatorSqlConnection(MercatorUi.Globals.RepData, true))
{
if (dbConn.Connection == null)
return;
using (SqlCommand cmd = new SqlCommand("update...", dbConn.Connection))
{
...
}
}