Gebruik van Zselect

0000001530 - 24-06-2025

De Api van Mercator in MercatorTunnel.dll bevat de functie Zselect. Deze functie bevat een groot aantal oproepmogelijkheden en laat een aanzienlijke vereenvoudiging toe van de code die moet worden geschreven om een dataset te verkrijgen op basis van uit de SQL-databank van Mercator geëxporteerde gegevens.

De eerste voor deze functie in te voeren parameter moet de nodige informatie bevatten om verbinding te maken met de SQL-server, naar keuze:

een string met de gegevensdirectory van Mercator (REP_DATA): Mercator zal de nodige parameters in deze directory lezen en de SQL-verbinding maken (de verbinding wordt automatisch afgesloten na de oproep van Zselect);
een object van het type MercatorSqlConnection (de verbinding moet gemaakt zijn voor de oproep van Zselect en zal na de oproep niet afgesloten worden);

De tweede parameter moet het volgende bevatten:

ofwel een tekenreeks met de SQL-opdracht,
ofwel een object van het type SqlCommand,

Bijvoorbeeld:

DataSet ds = Api.Zselect(repData, "select * from users (NOLOCK) order by nom");

Indien de gegevensdirectory van Mercator de eerste parameter is, kan men tot 9 bijkomende parameters invoeren met de eventueel in de SQL-opdracht in te voeren parameters. Deze parameters moeten een object van het type MercatorSqlParam.

Daarnaast zijn er een hele reeks handtekeningen beschikbaar:

public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, List<MercatorSqlParam> listPp);
 public static DataSet Zselect(MercatorSqlConnection conn, SqlTransaction transac, string reqSql, List<MercatorSqlParam> listPp);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, List<MercatorSqlParam> listPp, SqlTransaction Transaction);
 public static DataSet Zselect(SqlConnection conn, SqlCommand Comm);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam p1);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam p1, MercatorSqlParam p2);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6, MercatorSqlParam p7);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6, MercatorSqlParam p7, MercatorSqlParam p8);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6, MercatorSqlParam p7, MercatorSqlParam p8, MercatorSqlParam p9);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, List<MercatorSqlParam> listPp);
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, MercatorSqlParam[] pp);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam[] pp);
 public static List<T> Zselect<T>(MercatorSqlConnection conn, string reqSql, List<MercatorSqlParam> listPp);
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam[] pp, SqlTransaction Transaction, bool withSchema); 
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6, MercatorSqlParam p7, MercatorSqlParam p8, MercatorSqlParam p9);         
 public static DataSet Zselect(SqlConnection conn, SqlCommand cmd, MercatorSqlParam[] pp, SqlTransaction Transaction);
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6, MercatorSqlParam p7, MercatorSqlParam p8);
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, MercatorSqlParam p1);
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6); 
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6, MercatorSqlParam p7); 
 public static DataSet Zselect(string repData, string reqSql); 
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam p1); 
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2);
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4);
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5);
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4);
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3);
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2);
 public static DataSet Zselect(MercatorSqlConnection conn, string reqSql);
 public static DataSet Zselect(string repData, SqlCommand cmd);
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam[] pp, bool withSchema);
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam[] pp);
 public static DataSet Zselect(string repData, string reqSql, List<MercatorSqlParam> listPp, bool withSchema);
 public static DataSet Zselect(string repData, string reqSql, List<MercatorSqlParam> listPp);
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6, MercatorSqlParam p7, MercatorSqlParam p8, MercatorSqlParam p9);
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6, MercatorSqlParam p7, MercatorSqlParam p8);
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6, MercatorSqlParam p7);
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5, MercatorSqlParam p6);
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3, MercatorSqlParam p4, MercatorSqlParam p5);
 public static DataSet Zselect(string repData, string reqSql, MercatorSqlParam p1, MercatorSqlParam p2, MercatorSqlParam p3);

Deze methode bestaat ook in een asynchrone versie: ZselectAsync.

Gebruik van MercatorSqlParam (aanbevolen keuze)

Deze objectklasse beschikt over 2 verschillende constructeurs:

Eerste constructeur:

Naam van de parameter: start altijd met @
Waarde van de parameter
Type parameter (SqlDbType)

Tweede constructeur:

Naam van de parameter: start altijd met @
Waarde van de parameter
Type parameter (SqlDbType)
Lengte voor het type (int)

Bijvoorbeeld:

string reqsql = "select * from cli where (c_nom=@NOM) and (c_codep=@CODEP) and (c_id<>@ID)";
DataSet ds = Api.Zselect(rep_data, reqsql, new MercatorSqlParam("@NOM", nom, SqlDbType.VarChar), 
                                           new MercatorSqlParam("@CODEP", codep, SqlDbType.Char), 
                                           new MercatorSqlParam("@ID", id, SqlDbType.Char, 10));

Methode Zselect<T>() ook zien.

Gebruik van Zselect

Dit website gebruikt cookies