Hola a tod@s, hoy quiero explicarles como utilizar ADO.NET en Windows Mobile contra una base de datos SQL Mobile.
Este artículo va a ser un poco largo, pero quiero responder aquí muchas de las preguntas que me hacen en los foros donde participo: ¿Cómo creo una base de datos SQL Mobile, cómo inserto registros en esa base de datos, como elimino registros de esa base de datos, como edito o modifico la información, como muestro la información en una grilla?
A muchos les parecerá mucho mas fácil trabajar con el control enlazado a datos de Windows Mobile BindingSource, pero considero que no se tiene todo el control que uno debe tener con los datos con este control. Sin embargo como dice un refrán aquí en Colombia “Entre gustos no hay disgustos…”, los que desean hacerlo lo utilizan y cuando una consulta hay que cambiarla se enfrentan a inconvenientes para poder crearla como se necesita.
Estos son mis puntos de vista y todos pensamos y hacemos las cosas diferentes, así que no tomen esto como una regla en sus desarrollos.
Este artículo va a tratar de utilizar todas las funciones necesarias de ADO.NET para Windows Mobile a partir del código.
Definición Estructura Tabla
Bueno, entonces empecemos con este tema, lo primero que vamos a hacer es definir una estructura de una tabla a la cual vamos a aplicar las operaciones del CRUD (Create, Remove, Update, Display) por sus siglas en inglés.
Nuestra tabla es una tabla de contactos personales la cual va a contener las siguientes columnas:
- Id, entero, auto numérico y llave de la tabla
- Nombre, nvarchar de 150 caracteres de longitud
- Direccion, NVarchar de 150 caracteres de longitud
- Telefono, NVarchar de 10 caracteres de longitud
- Celular, Nvarchar de 10 caracteres de longitud
Habiendo definido nuestra tabla o nuestras tablas, vamos a recordar como crear por código la base de datos en la PDA, y luego como aplicar los diferentes métodos de ADO.NET para el manejo de los datos.
Creación del Proyecto a desarrollar
Empecemos, abrimos nuestro ambiente de desarrollo Visual Studio 2008, para esto y seleccionamos crear un nuevo proyecto:
No muestra la pantalla de seleccionar el tipo de proyecto a crear:
En esta pantalla seleccionamos el lenguaje sobre el cual vamos a trabajar, también el tipo de proyecto a desarrollar, como vemos en la imagen seleccionamos Smart Device, que es el tipo de proyecto para Windows Mobile.
Además le asignamos un nombre al proyecto, pueden observar en la imagen que en las plantillas solo aparece una como “Proyecto de Smart Device”, en el siguiente paso vamos a seleccionar ya el tipo de proyecto dentro de esta plantilla.
Al presionar el botón Aceptar nos muestra la siguiente pantalla :
En la parte superior y esto solo es a partir de Visual Studio 2008, nos permite seleccionar la plataforma de destino ( Platform Target) y la versión del .NET Compact Framework para el cual vamos a desarrollar.
Luego de haber seleccionado estos datos vamos seleccionar el tipo de aplicación a desarrollar, como vamos a crear una aplicación para windows mobile, debemos seleccionar la plantilla de Aplicación de Dispositivo.
De acuerdo a los diferentes SDK de Windows Mobile instalados en nuestro PC de desarrollo, esta lista puede tener las opciones que aparecen o menos, en mi caso tengo instalados los SDK de Windows Mobile versión 2003, 5 y 6 Professional y Standard (antes llamado smart phone).
Vamos a seleccionar la plataforma Windows Mobile 6 Profesional SDK.
Para el caso de la versión del CF.NET sobre la cual vamos a desarrollar, vamos a seleccionar la versión 3.5, y le damos clic al botón de Aceptar de esta pantalla para que nos abra nuestro ambiente de desarrollo y el formulario para empezar a desarrollar nuestra aplicación.
Como podemos apreciar en la imagen el formulario creado por default en su parte superior derecha tiene una equis “X”, esto significa que se va a minimizar el formulario al presionarla, no se va a cerrar la aplicación como deseamos, para esto vamos a ir al panel de propiedades y vamos a cambiar la propiedad MinimizeBox a False.
Con esto nuestro formulario muestra un botón de OK, que si permite cerrar la aplicación cuando hagamos clic sobre el.
Después de haber configurado nuestro formulario, lo primero que debemos hacer es adicionar a nuestra solución la referencia al espacio de nombres que maneja las bases de datos SQL Mobile, por defecto esta referencia no viene en los proyectos.
Para adicionar la referencia hacemos clic derecho sobre “References” y nos muestra la lista de todos los assemblies que podemos utilizar en nuestro desarollo.
Y ubicamos en la lista System.Data.SqlServerCe, lo seleccionamos y presionamos el botón de Aceptar de la ventana:
Con esto este Espacio de nombre ya queda incluido en las referencias:
Hacemos doble clic sobre el formulario para que se abra la ventana de código en el evento load de la forma, aquí vamos a verificar que exista la base de datos .sdf, que es la extensión de los archivos de SQL Mobile.
Para esto necesitamos incluir el using de System.IO al principio de la clase que maneja el formulario, para poder hacer uso de la función que verifica si un archivo existe o no en el sistema de archivos de Windows Mobile.
Además necesitamos los using de System.Configuration y System.Reflection, para obtener la ruta en la cual se encuentra el ejecutable de la aplciación y verificar que el archivo .sdf se encuentre en esa misma ruta.
Por ultimo necesitamos el using de System.Data.SqlServerCe, para poder tener acceso al proveedor de datos y realizar las operaciones necesarias sobre la base de datos.
Verificar si el archivo .sdf existe
using System.IO;
using System.Configuration;
using System.Reflection;
using System.Data.SqlServerCe;
namespace CRUDWMCS
{
public partial class Form1 : Form
{
// Obtengo por Reflexion la ruta completa del archivo .exe
String nombreExe = Assembly.GetExecutingAssembly().GetName().CodeBase;
String ruta = String.Empty;
public Form1()
{
InitializeComponent();
}
private void Form1_Load(object sender, EventArgs e)
{
// Obtengo la ruta del archivo .exe
ruta = nombreExe.Substring(0, nombreExe.LastIndexOf(@"\") + 1);
if (!File.Exists(ruta + "DemoBD.sdf"))
{
// Instancio SqlCeENgine para crear la base de datos .sdf
SqlCeEngine engine = new SqlCeEngine("Data Source= " + ruta + "DemoBD.sdf;"););
}
}
}
}
Luego de obtener la ruta del archivo .exe, en la variable ruta de tipo String, pregunto si el archivo no existe, haciendo uso de File.Exist, si esta condición es verdadera procedemos a crear la base de datos.
Crear la base de datos:
Creamos el archivo de base de datos con estas instrucciones:
// Instancio SqlCeENgine para crear la base de datos .sdf
SqlCeEngine engine = new SqlCeEngine("Data Source= " + ruta + "DemoBD.sdf;"););
engine.CreateDatabase();
engine.Dispose();
Luego procedemos a crear la tabla que vamos a necesitar, para esto utilizando ADO.NET, abrimos una conexión a la base de datos, creamos un comando para ejecutar la instrucción de creación de la tabla en la base de datos y por ultimo cerramos la conexión a la base de datos.
A continuación como queda el código del evento Load de la forma en la cual se crea la base de datos y la tabla a utilizar:
private void Form1_Load(object sender, EventArgs e)
{
// Obtengo la ruta del archivo .exe
ruta = nombreExe.Substring(0, nombreExe.LastIndexOf(@"\") + 1);
if (!File.Exists(ruta + "DemoBD.sdf"))
{
// Instancio SqlCeEngine para crear la base de datos .sdf
SqlCeEngine engine = new SqlCeEngine("Data Source= " + ruta + "DemoBD.sdf;");
engine.CreateDatabase();
engine.Dispose();
// Instancio la conexion a la base de datos
SqlCeConnection conn = new SqlCeConnection();
StringBuilder sbQuery = new StringBuilder();
SqlCeCommand cmd = new SqlCeCommand();
try
{
// Indico la cadena de conexion a utilizar para abrir la base de datos SQL Mobile
conn.ConnectionString = "Data Source= " + ruta + "DemoBD.sdf;";
// Abro la conexion a la base de datos
conn.Open();
// Creo la sentencia SQL a utilizar
sbQuery.Append("CREATE TABLE Contactos( ");
sbQuery.Append(" Id int IDENTITY(1,1) NOT NULL ");
sbQuery.Append(" ,Nombre nvarchar(150) NOT NULL ");
sbQuery.Append(" ,Direccion nvarchar(150) NOT NULL ");
sbQuery.Append(" ,Telefono nvarchar(10) NOT NULL ");
sbQuery.Append(" ,Celular nvarchar(10) NOT NULL ");
sbQuery.Append(" , CONSTRAINT CONTACTOS_PK PRIMARY KEY ");
sbQuery.Append(" ( ");
sbQuery.Append(" Id ");
sbQuery.Append(" ) ");
sbQuery.Append(" ) ");
// Configuro el objeto commando para ejecutar la sentencia SQL
cmd.CommandText = sbQuery.ToString();
// Asigno la conexion al objeto commando
cmd.Connection = conn;
// Ejecuto la instruccion
cmd.ExecuteNonQuery();
conn.Close();
conn.Dispose();
}
catch (SqlCeException sqlEx)
{
MessageBox.Show("Ha ocurrido una excepción:\r\n" + sqlEx.Message, "Abriendo Base de Datos");
return;
}
}
}
Si ejecutamos nuestra aplicación hasta este momento vamos a observar en el directorio el archivo de la base de datos.
En las imágenes anteriores podemos observar que la base de datos se creo de manera correcta al igual que la tabla.
Recapitulando un poco:
Para crear la base de datos: se necesita el objeto SqlCeEngine de ADO.NET para SQL Mobile.
Para crear la tabla por código: Se necesita:
- un objeto SqlCeConnection que establece y abre la conexión con la base de datos SQL Mobile.
- un objeto SqlCeCommand que permite ejecutar las sentencias SQL contra la base de datos utilizando el objeto SqlCeConnection creado en el paso anterior.
Ahora que ya tenemos la base de datos con su tabla creada, vamos a crear una opción en el menú para adicionar registros a nuestra tabla, para esto vamos a adicionar al menú la opción Adicionar y vamos a crear un panel para la captura de los datos.
Además vamos a adicionar un Panel que nos servirá para simular una ventana con los datos a capturar.
Dentro del panel vamos a colocar controles label y controles TextBox que nos permitan capturar los datos de diferentes datos de la tabla. Nuestro panel de captura va a quedar de al siguiente manera:
En el evento click del botón grabar vamos a colocar toda la lógica de la grabación de los datos, a continuación el código del botón:
Adicionar Registro
// Grabar los datos en la tabla
private void btnGrabar_Click(object sender, EventArgs e)
{
SqlCeConnection conn = new SqlCeConnection();
StringBuilder sbQuery = new StringBuilder();
SqlCeCommand cmd = new SqlCeCommand();
try
{
// Indico la cadena de conexion a utilizar para abrir la base de datos SQL Mobile
conn.ConnectionString = "Data Source= " + ruta + "DemoBD.sdf;";
// Abro la conexion a la base de datos
conn.Open();
// Creo la sentencia SQL a utilizar
sbQuery.Append("INSERT INTO Contactos ( ");
sbQuery.Append(" Nombre ");
sbQuery.Append(" ,Direccion ");
sbQuery.Append(" ,Telefono ");
sbQuery.Append(" ,Celular ");
sbQuery.Append(" ) VALUES ( ");
sbQuery.Append(" '" + txtNombre.Text + "'");
sbQuery.Append(" ,'" + txtDireccion.Text + "'");
sbQuery.Append(" ,'" + txtTelefono.Text + "'");
sbQuery.Append(" ,'" + txtCelular.Text + "'");
sbQuery.Append(" ) ");
// Configuro el objeto commando para ejecutar la sentencia SQL
cmd.CommandText = sbQuery.ToString();
// Asigno la conexion al objeto commando
cmd.Connection = conn;
// Ejecuto la instruccion
cmd.ExecuteNonQuery();
LimpiarCampos();
}
catch (SqlCeException sqlEx)
{
MessageBox.Show("Ha ocurrido una excepción:\r\n" + sqlEx.Message, "Grabando Datos");
}
finally
{
conn.Close();
conn.Dispose();
}
}
En este código utilizamos los objeto SqlCeConnection para establecer al conexión con la base de datos, SqlCeCommand para ejecutar la instrucción INSERT en la tabla y adicionar los datos del contacto, como siempre todo esto debe estar dentro de un bloque try… catch para capturar las excepciones si llega a ocurrir alguna al momento de ejecutar el comando.
El método LimpiarCampos() lo que hace es limpiar los controles textbox utilizados.
Editar o Modificar Datos
Para la edición de los datos, vamos a crear un nuevo Panel y dentro colocar los controles necesarios para poder realizar estas modificaciones al registro, además un campo para pedir el ID del registro y traer los datos y editarlos.
La pantalla de edición queda de esta manera:
Buscar un Contacto
El botón buscar ejecuta una sentencia SELECT contra la tabla de Contactos para ubicar el ID digitado, si no lo encuentra muestra un mensaje indicando esta situación, si lo encuentra rellena los controles con los valores obtenidos de la base de datos.
Para realizar esta operación, abrimos la conexión ala base de datos a través de SqlCeConnect, y utilizando un SqlCeCommand ejecutamos una sentencia contra la base de datos, como esta sentencia a diferencia de las anteriores si devuelve un resultado, que será el registro que estamos buscando, utilizamos el método ExecuteReader del objeto Comando para esta operación.
En nuestro programa declaramos una variable de tipo IDataReader para que pueda recibir los datos y procesarlos de acuerdo a nuestras necesidades.
Una vez tenemos los datos en el DataReader los leemos y llenamos los controles textbox con sus correspondientes valores.
A continuación el código del botón Buscar:
// Boton Buscar un registro de acuerdo al id
private void btnBuscar_Click(object sender, EventArgs e)
{
SqlCeConnection conn = new SqlCeConnection();
StringBuilder sbQuery = new StringBuilder();
SqlCeCommand cmd = new SqlCeCommand();
IDataReader dr;
try
{
// Indico la cadena de conexion a utilizar para abrir la base de datos SQL Mobile
conn.ConnectionString = "Data Source= " + ruta + "DemoBD.sdf;";
// Abro la conexion a la base de datos
conn.Open();
// Creo la sentencia SQL a utilizar
sbQuery.Append("SELECT Id ");
sbQuery.Append(" ,Nombre " );
sbQuery.Append(" ,Direccion ");
sbQuery.Append(" ,Telefono " );
sbQuery.Append(" ,Celular " );
sbQuery.Append("FROM Contactos ");
sbQuery.Append(" WHERE ID = " + txtID.Text);
// Configuro el objeto commando para ejecutar la sentencia SQL
cmd.CommandText = sbQuery.ToString();
// Asigno la conexion al objeto commando
cmd.Connection = conn;
// Ejecuto la instruccion
dr = cmd.ExecuteReader();
while (dr.Read())
{
txtEditNombre.Text = dr["Nombre"].ToString();
txtEditDireccion.Text = dr["Direccion"].ToString();
txtEditTelefono.Text = dr["Telefono"].ToString();
txtEditCelular.Text = dr["Celular"].ToString();
}
// Cierro el DataReader
dr.Close();
if(txtEditNombre.Text == String.Empty)
MessageBox.Show("Registro no Existe, Verifique.", "Editar Contactos");
}
catch (SqlCeException sqlEx)
{
MessageBox.Show("Ha ocurrido una excepción:\r\n" + sqlEx.Message, "Grabando Datos");
}
finally
{
// Cierro la conexion
conn.Close();
conn.Dispose();
}
}
Ahora que ya podemos ubicar o buscar un registro dentro de nuestra tabla de contactos, podemos cambiar los diferentes datos del registro y grabar las modificaciones, para esto vamos a codificar el botón grabar del panel de Edición de los datos.
A continuación el código para grabar los datos modificados:
// Boton grabar los cambios en el registro
private void btnEditGrabar_Click(object sender, EventArgs e)
{
SqlCeConnection conn = new SqlCeConnection();
StringBuilder sbQuery = new StringBuilder();
SqlCeCommand cmd = new SqlCeCommand();
try
{
// Indico la cadena de conexion a utilizar para abrir la base de datos SQL Mobile
conn.ConnectionString = "Data Source= " + ruta + "DemoBD.sdf;";
// Abro la conexion a la base de datos
conn.Open();
// Creo la sentencia SQL a utilizar
sbQuery.Append("UPDATE Contactos SET ");
sbQuery.Append(" Nombre " + "= '" + txtNombre.Text + "'");
sbQuery.Append(" ,Direccion " + "= '" + txtDireccion.Text + "'");
sbQuery.Append(" ,Telefono " + "= '" + txtTelefono.Text + "'");
sbQuery.Append(" ,Celular " + "= '" + txtCelular.Text + "'");
sbQuery.Append(" WHERE ID = " + txtID.Text);
// Configuro el objeto commando para ejecutar la sentencia SQL
cmd.CommandText = sbQuery.ToString();
// Asigno la conexion al objeto commando
cmd.Connection = conn;
// Ejecuto la instruccion
cmd.ExecuteNonQuery();
LimpiarCamposEdit();
MessageBox.Show("Registro Editado de manera Correcta", "Editar Contactos");
}
catch (SqlCeException sqlEx)
{
MessageBox.Show("Ha ocurrido una excepción:\r\n" + sqlEx.Message, "Grabando Datos");
}
finally
{
conn.Close();
conn.Dispose();
}
}
Como podemos apreciar en el código anterior, armamos un sentencia SQL UPDATE para modificar los datos de nuestra tabla, aquí una de las´partes más importantes es el WHERE, tengan muy presente que si hacemos una sentencia UPDATE sin un WHERE se aplicaran los cambios a todos los registros de la tabla, por esto es muy importante esta sentencia en un UPDATE.
Eliminar Registros de la Tabla
Para eliminar los registros, vamos al menú y creamos una nueva opción de Eliminar, esta opción va a llamar nuevamente al panel de edición, pues todo nos sirve, el botón de buscar, la rutina que rellena los controles con al información guardada en la base de datos, el botón de cancelar o salir, únicamente vamos a crear un código que si se llama desde al opción Eliminar el texto del botón grabar cambia a “Eliminar” y se realizará la acción de eliminar el registro.
Al eliminar vamos a verificar que el campo de Nombre no este vacío, esto nos garantizará que no ocurra un error al intentar eliminar un registro sin verificarlo. A continuación el código de eliminar:
else
{
// VERIFICO QUE HAYA CONSULTADO A ALGUIEN
if (txtEditNombre.Text == String.Empty)
{
MessageBox.Show("No ha Seleccionado un Contacto para eliminar", "Eliminando Contactos");
return;
}
// Eliminar el registro de la Tabla de Contactos
try
{
// Indico la cadena de conexion a utilizar para abrir la base de datos SQL Mobile
conn.ConnectionString = "Data Source= " + ruta + "DemoBD.sdf;";
// Abro la conexion a la base de datos
conn.Open();
// Creo la sentencia SQL a utilizar
sbQuery.Append("DELETE FROM Contactos ");
sbQuery.Append(" WHERE ID = " + txtID.Text);
// Configuro el objeto commando para ejecutar la sentencia SQL
cmd.CommandText = sbQuery.ToString();
// Asigno la conexion al objeto commando
cmd.Connection = conn;
// Ejecuto la instruccion
cmd.ExecuteNonQuery();
LimpiarCamposEdit();
MessageBox.Show("Registro Eliminado de manera Correcta", "Eliminar Contactos");
}
catch (SqlCeException sqlEx)
{
MessageBox.Show("Ha ocurrido una excepción:\r\n" + sqlEx.Message, "Eliminando Datos");
}
finally
{
conn.Close();
conn.Dispose();
}
}
Como se puede apreciar es el else del botón de Editar, pues recuerden que estamos utilizando la misma forma que en editar.
Desplegar Datos en una Grilla
Por último vamos a crear una nueva opción en el menú que nos permita listar todos los registros de la tabla para colocarlos dentro de un control ListView, que de acuerdo a las pruebas que yo he realizado es mucho mas rápido en Windows Mobile que un control datagrid, aquí nuevamente, les digo si necesita o prefieren utilizar un control datagrid lo pueden utilizar pues este si puede ser enlazado a datos (Bindable), esto queire decir que cuenta con una propiedad DataSource, mientras que el control ListView, no cuenta con esta propiedad.
Para esto vamos a agregar un nuevo panel al formulario llamado panDisplay y cuya propiedad Visible la vamos a colocar a false igual que los otros, al cual le vamos a asociar un control ListView.
El control ListView lo vamos a configurar para que muestre una lista pues este control puede comportarse para mostrar los mismos datos de diferentes maneras. Para hacer esto, vamos a cambiar la propiedad View del control al valor Details, al hacer esto, aparece una barra de títulos en el control.
También vamos a ubicar la propiedad FullRowSelect y la vamos a colocar a True.
El siguiente paso es configurar las diferentes columnas que va a mostrar el control, para esto vamos a ir a la propiedad Columns, como lo muestra la siguiente imagen:
Esto nos muestra una ventana para configurar las diferentes columnas que queremos tenga nuestro control.
Utilizamos el botón Agregar para adicionar las columnas que queremos muestre nuestro control ListView.
Como se puede apreciar en la imagen, por cada columna podemos cambiar las propiedades que aparecen a la derecha, las propiedades más importantes a cambiar son: Text, que indica el texto de esa columna dentro del control, y Width, que indica el ancho que va a tener esa columna para mostrar los datos, también podremos controlar el alineamiento que va a tener esa columna, por defecto será a la izquierda.
Nuestro formulario se verá de al siguiente forma:
Agregamos un botón de Cerrar para cerrar esta pantalla y regresar a la pantalla principal.
El código del ítem del menú que llama esta opción es el siguiente:
// Menu Mostrar la lista de Contactos en Grilla
private void menuItem6_Click(object sender, EventArgs e)
{
panDisplay.Location = new Point(3, 3);
panDisplay.Visible = true;
CargarDatosGrilla();
}
El método CargarDatosGrilla, se encarga de llenar el control ListView con los datos que existan en la tabla de contactos.
A continuación el código para llenar el ListView con los datos de la tabla
/// <summary>
/// Metodo que carga los datos de Contactos en al Grilla
/// </summary>
private void CargarDatosGrilla()
{
SqlCeConnection conn = new SqlCeConnection();
StringBuilder sbQuery = new StringBuilder();
SqlCeCommand cmd = new SqlCeCommand();
IDataReader dr;
try
{
// Indico la cadena de conexion a utilizar para abrir la base de datos SQL Mobile
conn.ConnectionString = "Data Source= " + ruta + "DemoBD.sdf;";
// Abro la conexion a la base de datos
conn.Open();
// Creo la sentencia SQL a utilizar
sbQuery.Append("SELECT Id ");
sbQuery.Append(" ,Nombre ");
sbQuery.Append(" ,Direccion ");
sbQuery.Append(" ,Telefono ");
sbQuery.Append(" ,Celular ");
sbQuery.Append("FROM Contactos ");
// Configuro el objeto commando para ejecutar la sentencia SQL
cmd.CommandText = sbQuery.ToString();
// Asigno la conexion al objeto commando
cmd.Connection = conn;
// Ejecuto la instruccion
dr = cmd.ExecuteReader();
// Declaro un objeto ListViewItem, para cargar lso registros en el Control ListView
ListViewItem lvItem = new ListViewItem();
// Limpio el control Listview, antes de empezar a llenarlo
listView1.Items.Clear();
// recorro el dataReader para leer todos los registros
while (dr.Read())
{
// Inicializo el Control
lvItem = new ListViewItem();
// Lleno los datos de la fila del control
lvItem.Text = dr["Id"].ToString();
lvItem.SubItems.Add( dr["Nombre"].ToString());
lvItem.SubItems.Add( dr["Direccion"].ToString());
lvItem.SubItems.Add( dr["Telefono"].ToString());
lvItem.SubItems.Add( dr["Celular"].ToString());
// Agrego la fila al control
listView1.Items.Add(lvItem);
}
// Cierro el DataReader
dr.Close();
}
catch (SqlCeException sqlEx)
{
MessageBox.Show("Ha ocurrido una excepción:\r\n" + sqlEx.Message, "Grabando Datos");
}
finally
{
// Cierro la conexion
conn.Close();
conn.Dispose();
}
}
Bueno espero que con este artículo se aclaren muchas dudas al respecto de como hacer o utilizar ADO.NET en Windows Mobile con el Compact Framewok .NET.
En un próximo artículo explicare como utilizar la arquitectura de N-Capas en aplicaciones para Windows Mobile.
Saludos y que lo disfruten!!!
