Vista general de un ActiveX para la conectividad

ODBC

Definición del control

Objetivo:

Programar aplicaciones en VB con conectividad vía ODBC para administración de bases de datos de una manera rápida y eficaz., así mismo reducir el tiempo de desarrollo en aplicaciones Cliente/Servidor.

Alcance:
Contar con un control que sepa:

Conectarse y desconectarse en forma automática.
Barrer el resultado de un query en forma dinámica.
Llenar un control con el resultado de un query en forma inteligente, es decir, que sepa que tipo de control es, y en base a este manejar la información devuelta por el query.
Grabar el resultado de un query en un archivo especificando el tipo de separador entre campos.
Llenar un arreglo bidimensional con el resultado de un query.
Que comparta los handles con el fin de aprovechar la conexión abierta y que el programador realice las operaciones odbc manualmente.
Administrar múltiples conexiones.
Crear Data Sources al vuelo, ya que es muy tedioso el hecho de crearlos manualmente en la instalación de cada aplicación.
Mostrar una ventana de login completa y amigable.

Observaciones:

El control no validará el contenido del query ni el tamaño del resultset. En caso de que estos u otros procesos ocasionen errores, el control disparará el evento OError, el cual recibe como parámetro el número de error y la descripción del mismo.

Propiedades:

Nombre	Tipo	Descripción
ActiveConnection	Boolean	Indica el número de conexión activa
UserName	String (32)	Nombre del usuario para conexión al servidor
Password	String (32)	Contraseña del usuario para validación de conexión
DSN	String (255)	Nombre del Data Source Name registrado en odbc.
Database	String (32)	Nombre de la base de datos a la cual se conectará el control.
Henv	Long	Handle del Environment
HDbc	Long	Handle de la conexión
HStmt	Long	Handle del Statement
AutoConnect	Boolean	Indica si la conexión será abierta automáticamente al ejecutarse la aplicación.
MaxConnections	Integer	Limita a un número de conexiones máximo
Server	String(32)	Nombre del Servidor al que se conectará el control
NumConnections	Integer	Indica el Número de Conexiones abiertas.

Métodos:

Nombre	Tipo	Descripción
Connect		Establece conexión con el DSN registrado en odbc tomando las propiedades DSN, Usuario, Contraseña y BD. Al conectarse con éxito se asigna un valor verdadero a la propiedad Conectado. Si la propiedad AutoConexion es verdadera se ejecutará automáticamente este método al iniciar la aplicación.
Disconnect		Elimina la conexión establecida por el método Conectar y asigna el valor False a la propiedad Conectado. Si al terminar la aplicación no se ha cerrado la conexión, esta se cerrará en forma automática.
FillArray	Boolean	Función que llena un arreglo bidimensional con la información del resultado de un query. Los parámetros son Query y Arreglo. La cual devuelve el valor true en caso de que sea exitosa la operación o de lo contrario false
FillFile	Boolean	Función que almacena el resultado de un query en un archivo, devuelve true si resulta exitosa o false en caso contrario.
FillObject		Rutina que llena un control con el resultado de un query, parámetros: Query y Control, controles soportados son:
ExecuteQuery	Integer	Función que ejecuta un query pasado como parámetro y devuelve el valor obtenido por odbc.
GetNumColumns		Rutina que devuelve el numero de columnas del resultado del query según el handle.
MoveNextRow	Integer	Función que posiciona el indicador en el siguiente registro del resultado del query.
GetData	Variant	Función que devuelve el valor obtenido del resultado del query en base a la columna que se especifique.
CerrarQuery		Libera el handle del statement abierto por AbrirQuery.
Reconnect		Utiliza los mismo valores de la conexión activa (truncada) para reconectarla.
FillVariable	Variant	Devuelve el resultado del query concatenado con el separador indicado.
FreeQuery	Boolean	Libera un estatuto abierto según la conexión indicada.
GetColumnType		Devuelve con parámetros de salida las características de una columna específica.
GetDSNList		Llena una arreglo con los DSN registrado en ODBC.
LogOn	Boolean	Muestra una ventana de conexión con título, subtítulo y comentarios parametrizables y devuelve un booleano según si se ha establecido la conexión o no.

Eventos:

Nombre	Descripción
ConnectionBrocked	Sucede cuando el control detecta que el servidor no responde, se asume que se a truncado la conexión.
OError	Sucede cuando ocurre un error de odbc.

ODBC

Definición del control

Este trabajo ha sido realizado por Juan José de la Cruz