Changes between Version 2 and Version 3 of DBConnect

Timestamp:

Jun 19, 2013, 10:43:45 AM (12 years ago)

Author:

Pedro Gea

Comment:

--

DBConnect

@@ -57 +57 @@
 }}}
 
+== Almacenar y recuperar una conexión ==
+
+Para facilitar el uso de las conexiones creadas, TOL permite almacenarlas y recuperarlas y utilizarlas en una sesión de TOL diferente.
+
+=== Almacenar una conexión ===
+
+Para almacenar una conexión simplemente debemos ejecutar su método {{{Store}}}:
+
+{{{
+Real <dbConnection>::Store(?);
+}}}
+
+Este método crea un archivo con el nombre <alias>.dbc que contiene la información de la conexión embebida.
+El archivo se ubica en el directorio de datos de programa de TOL. 
+Concretemente en la carpeta "DBConnect" ({{{Text TolAppDataPath<<"DBConnect/"}}}).
+
+=== Recuperar una conexión ===
+
+Si queremos volver a obtener una referencia a la conexión dentro de la misma sesión TOL 
+en que fue creada (por ejemplo, por que decompilamos la que teníamos) basta con hacer:
+
+{{{
+NameBlock db = DBConnect::GetConnection(<alias>);
+}}}
+
+Si en lugarde esto, intentamos volvemos a crear la conexión, obtendremos un mensaje que nos avisa
+de que la conexión ya estaba creada y se nos devolverá la conexión que ya existía.
+
+Para recuperar una conexión ya almacenada en una nueva sesión de TOL, usaremos el método constructor {{{New}}}
+indicando como argumento sólo el alias de la conexión:
+
+{{{
+NameBlock db = DBConnect::New([[ Text alias = <alias> ]]);
+}}}
+
+== Utilizar una conexión ==
+
+Para utilizar una conexión, disponemos de los siguientes métodos:
+
+ * {{{Real <dbConnection>::Open(?)}}}: Abre la conexión con la base de datos.
+
+ * {{{Real <dbConnection>::Close(?)}}}: Cierra la conexión con la base de datos.
+
+ * {{{Real <dbConnection>::IsOpened(?)}}}: Nos permite determinar si la conexión con la base de datos está abierta o no.
+
+ * {{{Real <dbConnection>::Activate(?)}}}: Activa una conexión para su uso con las funciones {{{DBTable}}}, {{{DBExecQuery}}}, etc.
+   Este método nos permite alternar entre diferentes conexiones.
+
+ * {{{Real <dbConnection>::IsActive(?)}}}: Nos permite determinar si la conexión es la conexión activa.
 
 
+
+