Herramientas de usuario

Herramientas del sitio


componentes:wadoconnect

Tabla de Contenidos

wAdoConnect

Este componente nos crea una conexión a un servidor de Base de Datos SQL (MySQl, MariaDB, SQLLite, SQLServer, Firebird, Interbase o PostgreSQL) mediante ODBC utilizando ADO.

   WITH OBJECT wAdoConnect():New()
     :cHost   := "192.168.1.1"
     :cUser   := "user"
     :cPass   := "1234"
     :nEngine := xc_MariaDB
     :cDriver := "MariaDB ODBC 3.1 Driver"
     :Connect()
   END WITH

En caso de producirse algún error durante una tarea con el wAdoConnect, podemos consultar el error producido con;

  • Application:hAdoError[“Title”] - Que estará vacío si no se ha producido ningún error.
  • Application:hAdoError[“Text”] - Texto extra del error
  • Application:hAdoError[“Code”] - Código de error devuelto por la conexión.

Propiedades

Nombre Init Descripción Versión
lAbortOnErrors .F. Cancela la ejecución en caso de algún error 0.3.5
lDisplayErrors .F. Nos envía a Néfele Console el error que se ha producido 0.3.5
cLastError Código del error 0.3.5
cMsgError Mensaje del Error 0.3.5
cHost Servidor al que vamos a conectarnos (en SQLite no tiene uso) 0.3.5
cUser Usuario para la conexión 0.3.5
cPassword Contraseña del Usuario 0.3.5
cDriver Driver ODBC que se utilizara para la conexión 0.3.5
cClientDLL Librería DLL que se utilizara en Firebird, hay que incluir el Path completo 0.3.5
nPort Puerto de conexión 0.3.5
nEngine xc_MariaDB Tipo de Base de datos 0.3.5
cConnect Si no utilizamos nEngine tendremos que indicarle la cadena de conexión 0.3.5
nTimeOut 20 Segundos de timeout en la conexión 0.3.5
aFileds Cabeceras de la ultima consulta SQL 0.3.5
nRecCount Número de registros recuperados en la ultima consulta SQL 0.3.5

Métodos

  • Connect( cConnect ) - Establece la conexión con el Servidor de Base de Datos, si hemos defino las propiedades de conexión no es necesario pasarle cConnect
  • Disconnect() - Cierra la conexión con el Servidor de Base de Datos.
  • Execute( cSelect ) - Ejecuta una cadena SQL, nos retorna .T. si se ha podido ejecutar.
  • BuildSQLSt( cSelect, ... ) - Nos permite construir una select con una plantilla.
  • QueryArray( cSelect, @aHeader ) - Devuelve un Array de registros (aunque se un solo registro devolverá un array bidimensional)
  • QueryArrayHash( cSelect, @aHeader ) - Devuelve un Array de Hash (aunque se un solo registro devolverá un array bidimensional)
  • QueryValue( cSelect, xDefault ) - Devuelve solo un valor, en caso de Nil devolverá xDefault.
  • QueryRecordSet( cSelect, @aHeader ) - Devuelve un RecordSet.
  • QueryRow( cSelect, @aHeader ) - Devuelve un array con los valores un registro.
  • QueryRowHash( cSelect, @aHeader ) - Devuelve un Hash con los valores de un registro.
componentes/wadoconnect.txt · Última modificación: 01/03/2021 09:53 por pedro