Índice de la sección dedicada a .NET (en el Guille) ADO .NET

Acceso a una base de datos de SQL Server con ADO.NET y Visual C#

Publicado el 05/Feb/2006
Actualizado el 05/Feb/2006
Autor: Guillermo 'guille' Som

Código de ejemplo válido para cualquier versión de Visual C#

 

Introducción

Este artículo en realidad consta de varias partes, aunque todas esas partes formarán un todo, y ese todo es un ejemplo muy básico (o elemental) de cómo acceder a una base de datos de tipo SQL Server usando ADO.NET y Visual Basic, (cualquier versión, ya sea la 1.x o la 2.0), permitiendo navegar entre los registros, añadir nuevos datos, modificar o borrar los existentes.

También veremos cómo saber las instancias de SQL Server que hay instaladas en el equipo, las cuales se mostrarán en un combo; al seleccionar la instancia, veremos cómo mostrar las bases de datos que tiene esa instancia, (excepto las del sistema o propias de SQL), las cuales estarán en otro combo.
Si la tabla de prueba no existe en la base de datos seleccionada, tendremos la posibilidad de crearla.

Además de lo dicho, en este ejemplo también verás cómo hacer lo siguiente:
-Deshabilitar los controles que estén incluidos en un GroupBox.
-Conectar a la base de datos de SQL Server usando la autenticación integrada de Windows.
-Obtener todos los datos indicados en una orden SELECT y guardarlos en un DataTable.
-Moverse por los registros de la tabla usando los típicos comandos: Primero, Anterior, Siguiente y Último.
-Añadir nuevos registros (o filas) a la tabla.
-Eliminar una fila de la tabla.
-Actualizar los datos de la fila actual.

Y como valor añadido, la utilidad de ejemplo también tiene código para:
-Saber las instancias de SQL Server.
-Saber las bases de datos de una instancia de SQL Server.
-Saber si una tabla en concreto existe en una base de datos de SQL.
-Crear una tabla (la usada en esta aplicación de ejemplo).

Espero que te sea de utilidad y que esté más claro y menos "liante" que el otro ejemplo que ya tenía publicado.

Nota:
A lo largo de este artículo, te muestro el código de Visual C#, pulsa este link si quieres ver el artículo con el código de ejemplo para Visual Basic.

Al final tienes el link al zip con el código de ejemplo para Visual C#, el cual es válido tanto para las versiones 2003 y 2005.

 

Nos vemos
Guillermo

P.S.
Pulsa aquí para ver un ejemplo parecido para una base de datos de tipo Access con OleDb.


 

Estructura de la tabla de ejemplo

Para que este código funcione, debes tener una base de datos en la que se incluya una tabla llamada Prueba.
Pulsa aquí si quieres saber cómo crear una base de datos de SQL Server usando código de Visual C#.

La estructura de esa tabla (Prueba) es la que se muestra en la siguiente tabla.
Si no la tienes creada en la base de datos que elijas, el programa te preguntará si la quieres crear, así que no te preocupes de que no la tengas creada.

Nombre campo Tipo Comentario
ID int Clave principal auto-numérica (identidad)
Nombre nvarchar 50 caracteres
e-mail nvarchar 128 caracteres
FechaAlta datetime -
Comentario nvarchar 2048 caracteres

 

 

El formulario para acceder a la base de datos

La aplicación de ejemplo tiene un formulario con el siguiente aspecto:

El formulario de la aplicación de ejemplo
El formulario de la aplicación de ejemplo

Como vemos, este formulario utiliza los campos que tiene la tabla que vamos a usar, por tanto, si vas a usar otra tabla diferente a la usada en el ejemplo, tendrás que crear tu propio diseño del formulario. En el código he intentado separar el código que depende de los campos, de forma que te resulte fácil de modificar.

Empezando por arriba, tenemos un ComboBox (cboInstancias) en el que mostraremos las instancias de SQL Server que hay instaladas en el equipo. Pulsa aquí si quieres saber cómo averiguar las instancias de SQL Server que hay en el equipo usando código de Visual C#.
A la derecha, tenemos otro ComboBox (cboBases) en el que mostraremos las bases de datos que tiene la instancia de SQL Server que hayamos seleccionado del primer combo. Pulsa aquí para saber cómo averiguar las bases de datos que contiene una instancia de SQL Server usando código de Visual C#.
El botón que está en la parte derecha, (btnConectar), (en la misma fila que los dos combos) nos servirá para conectarnos a la base de datos y a la instancia seleccionadas usando autenticación de Windows.
En ese botón se crea la conexión a la base de datos y se asigna el DataAdapter que usaremos para conectar directamente con la base de datos. Por tanto será en el código de ese botón donde tendrás que escribir todo lo necesario para realizar la conexión, cargar los datos en la tabla (DataTable) y empezar a mostrar los datos.
Al pulsar en el botón de conectar, el código comprueba si la tabla de pruebas existe, de no ser así, nos preguntará si la queremos crear.

En el GroupBox tenemos los controles para mostrar los datos, navegar entre las filas, actualizar, crear y eliminar registros.
Los botones de navegación (o movimiento) nos servirán para ir a los distintos registros: Primero, anterior, siguiente y último.
El botón de Actualizar lo usaremos para actualizar los datos del registro actual.
El botón Nuevo lo usaremos para añadir un nuevo registro. Cuando pulsamos en ese botón, se usarán los datos que actualmente tengamos en las cajas de textos, salvo el ID, ya que en la tabla de ejemplo es autonumérico, y por tanto se crea solo.
El botón de Eliminar lo usaremos para eliminar el registro que esté actualmente activo. Cuando se elimina el registro, los datos permanecen en los controles, por si queremos volver a crearlo, (pulsando en el botón Nuevo), aunque el ID usado será diferente al mostrado, ya que al crear un nuevo registro (o fila) el valor del campo ID se genera automáticamente.

Nota IMPORTANTE:
Las tres operaciones indicadas se hacen directamente en la base de datos, es decir, no trabajamos en modo desconectado, sino que cualquier cambio se reflejará inmediatamente en la base de datos.

El resto de controles simplemente los usamos para mostrar los datos.

 

 

Las variables comunes para todo el código

A lo largo de la aplicación usaremos algunas variables comunes, en realidad son tres:
dt del tipo DataTable, será la tabla a la que asignaremos los datos de la tabla de la base de datos
da del tipo SqlDataAdapter, será el adaptador que nos permitirá acceder a la base de datos, para leer los datos y actualizarlos.
fila del tipo int, será el índice de la fila actual, con idea de saber cual será la siguiente, la anterior o la fila que queremos actualizar.

// Las variables que usaremos en este ejemplo
private DataTable dt;
private SqlDataAdapter da;
private int fila;

 

 

Form_Load: Deshabilitar los controles y asignar el path de la base de datos

Al empezar la aplicación, en el evento Form_Load, deshabilitaremos los controles que están en el GroupBox, además, averiguaremos las instancias de SQL Server que hay actualmente en el equipo y las asignaremos en el combo correspondiente, también añadiremos al otro combo las bases de datos que contenga la instancia predeterminada de SQL Server, y si hay alguna base de datos (que no sea del sistema), seleccionaremos la primera (índice cero).

En este evento utilizamos una función llamada instanciasInstaladas, esa es la que nos indica las instancias de SQL Server que tenemos instaladas en nuestro equipo y si quieres ver el código puedes hacerlo desde este link.
En este mismo evento y en el correspondiente al cambio de selección del combo de las instancias, también usamos una función (basesDeDatos), que recibe como parámetro el nombre de la instancia seleccionada, para saber las bases de datos que tiene la instancia de SQL Server que hemos seleccionado, el código de esa función lo puedes ver siguiendo este link.

private void Form1_Load(object sender, EventArgs e) {
    this.Text="Ejemplo acceso SQL Server C#";

    // Limpiar los controles del GroupBox y
    // deshabilitarlos hasta que se conecte a la base de datos
    foreach(Control c in this.GroupBox1.Controls){
        // Limpiar los textbox
        if( c is TextBox ){
            c.Text = "";
        }
        // Deshabilitarlos
        c.Enabled = false;
    }
    this.GroupBox1.Enabled = false;
    this.GroupBox1.Text = "Debes conectar antes de usar los datos";
    //
    // Las instancias de SQL Server que hay instaladas
    string[] instancias;
    instancias = instanciasInstaladas();
    foreach(string s in instancias){
        if( s == "MSSQLSERVER" ){
            cboInstancias.Items.Add("(local)");
        }else{
            cboInstancias.Items.Add(@"(local)\" + s);
        }
    }
    cboInstancias.Text = "(local)";
 
    // Los nombres de las bases de datos
    string[] bases = basesDeDatos("(local)");
    if( bases != null ){
        this.cboBases.Items.AddRange(bases);
    }
    if( this.cboBases.Items.Count > 0 ){
        this.cboBases.SelectedIndex = 0;
    }
}

 

 

Al seleccionar una instancia, asignar las bases de datos que contiene

Como te he comentado antes, cuando seleccionamos una de las instancias del combo con los servidores (o instancias) de SQL Server, asignamos en el combo de las bases de datos, las que esa instancia contiene.
El código del evento SelectedIndexChanged es el siguiente, en el que comprobamos si hay alguna base de datos (la función que comprueba las bases que hay en la instancia indicada, devuelve Nothing si solo están las bases del propio SQL Server), las agregamos al combo y seleccionamos el primer elemento.

private void cboInstancias_SelectedIndexChanged(object sender, EventArgs e) {
    string[] bases = basesDeDatos(cboInstancias.Text);
    cboBases.Items.Clear();
    if( bases != null ){
        this.cboBases.Items.AddRange(bases);
    }
    if( cboBases.Items.Count > 0 ){
        cboBases.SelectedIndex = 0;
    }
}

 

 

Conectar a la base de datos

Para conectar con la base de datos y obtener los datos, necesitamos una cadena de conexión al servidor de SQL Server que indique que base de datos vamos a usar. Los datos los obtendremos mediante una cadena de selección (SELECT).

En el siguiente código comprobamos también si la tabla que usaremos existe en la base de datos seleccionada, para ello usaremos la función existeTabla a la que le pasaremos el objeto conexión que hemos creado y el nombre de la tabla que queremos comprobar si existe o no, que en nuestro ejemplo se llama Prueba.

Nota:
En realidad el objeto SqlConnection no hace falta para rellenar los datos por medio del DataAdapter, pero si lo necesitamos para comprobar si la tabla existe.

Una vez que tenemos la conexión creada y que sabemos que la tabla existe, crearemos los objetos que nos permitirán acceder a la base de datos (mediante un objeto del tipo SqlDataAdapter), y llenaremos el objeto DataTable con los datos que hayamos indicado en la cadena de selección.

Crearemos los comandos que necesitaremos para actualizar los datos en la base de datos (UPDATE, INSERT y DELETE). Esos comandos los creamos con un objeto del tipo SqlCommandBuilder que aunque no es la forma más efectiva, al menos es la más fácil de usar, y como de lo que en este artículo se trata es que sea fácil, pues eso... Los comandos los asignaremos a los objetos correspondientes del adaptador, esto en realidad no es necesario, pero algunas veces me ha dado error al no hacerlo, así que... ¡mejor estar seguros de que se asignan!.

Debido a que la tabla de ejemplo utiliza un campo autoincremental, tendremos que asignar a la propiedad MissingSchemaAction el valor AddWithKey, de esta forma, al añadir nuevos registros se incrementará el valor del ID.

En la tabla de ejemplo, estamos usando un campo que contiene caracteres que pueden ser conflictivos, en este caso es simplemente un guión, pero podría ser una vocal acentuada, una eñe o contener espacios, en este caso lo que hacemos es indicar en el objeto del tipo CommandBuilder que utilice prefijo y sufijo para "envolver" automáticamente esos campos conflictivos, esa indicación la hacemos mediante las propiedades QuotePrefix y QuoteSufix.

Por último creamos el nuevo objeto del tipo DataTable, que será el que usemos con el método Fill del adaptador, al usar ese método, será cuando se conecte con la base de datos y asigne a la tabla los datos indicados en la cadena de selección (SELECT).

En este ejemplo, le indico que traiga todos los datos, pero también podría haber seleccionado con una cláusula WHERE otros diferentes.

Otra cosa importante que debemos tener en cuenta con el código de selección (SELECT) es que si en lugar de indicar un asterisco para que se utilicen todos los campos ( SELECT * ), indicamos solo los campos que nos interesan, en las actualizaciones y lecturas de datos solo podremos incluir los campos indicados.
Por ejemplo, si hacemos: SELECT ID, Nombre FROM Prueba, tan solo tendremos acceso a esos dos campos, y cualquier intento de acceder a otros campos (aunque sean válidos y existan en la tabla) dará error.

Finalmente habilitamos nuevamente los controles que están en el GroupBox para que podamos navegar, añadir, eliminar, actualizar y escribir en las cajas de texto, y mostraremos el primer registro, para ello llamamos al código del evento del botón para mostrar el primer registro.
Si no hay datos, (es decir, si la tabla no contiene alguna fila), deshabilitamos el botón de actualizar y el de eliminar, para permitir solo añadir nuevos datos.

private void btnConectar_Click(object sender, EventArgs e) {
    // Conectar y mostrar los datos
    //
    // La cadena de conexión
    string sCnn = "Server=" + cboInstancias.Text + 
            "; " + "database=" + cboBases.Text + 
            "; integrated security=yes";
 
    SqlConnection cnn = new SqlConnection(sCnn);
    if( existeTabla(cnn, "Prueba") == false ){
        if( MessageBox.Show("NO existe la tabla Prueba, que es la usada para este ejemplo.\n" + 
            "¿Quieres crearla?", "No existe la tabla", MessageBoxButtons.YesNo) == DialogResult.Yes )
        {
            if( crearTablaPrueba() == false ){
                return;
            }
        }
        else{
            return;
        }
    }
 
    // La cadena de selección
    string sSel = "SELECT * FROM Prueba ORDER BY ID";
    //
    // Comprobar si hay algún error
    try{
        // Crear un nuevo objeto del tipo DataAdapter
        da = new SqlDataAdapter(sSel, sCnn);
        // Crear los comandos de insertar, actualizar y eliminar
        SqlCommandBuilder cb = new SqlCommandBuilder(da);
        // Como hay campos con caracteres especiales,
        // al usarlos incluirlos entre corchetes.
        cb.QuotePrefix = "[";
        cb.QuoteSuffix = "]";
        // Asignar los comandos al DataAdapter
        // (se supone que lo hace automáticamente, pero...)
        da.UpdateCommand = cb.GetUpdateCommand();
        da.InsertCommand = cb.GetInsertCommand();
        da.DeleteCommand = cb.GetDeleteCommand();
        //
        // Esta base de datos usa el ID con valores automáticos
        da.MissingSchemaAction = MissingSchemaAction.AddWithKey;
        //
        dt = new DataTable();
        // Llenar la tabla con los datos indicados
        da.Fill(dt);
        //
        // Habilitar los controles
        foreach(Control c in this.GroupBox1.Controls){
            c.Enabled = true;
        }
        this.GroupBox1.Enabled = true;
        this.GroupBox1.Text = "Conexión realizada";
 
        // Y mostrar el primer registro
        if( dt.Rows.Count > 0 ){
            btnFirst_Click(null, null);
        }
        else{
            fila = -1;
            btnActualizar.Enabled = false;
        }
    }
    catch(Exception ex){
        MessageBox.Show("ERROR al conectar o recuperar los datos:\n" + 
            ex.Message, "Conectar con la base", 
            MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

 

 

La función para saber si existe la tabla indicada

private bool existeTabla(SqlConnection cnn, string nombreTabla) {
    // Devuelve true si la tabla indicada está en la base usada con la conexión
    DataTable dt = new DataTable();
    bool existe = false;
    //
    try{
        SqlDataAdapter da = new SqlDataAdapter( 
                "SELECT * FROM INFORMATION_SCHEMA.TABLES " + 
                "WHERE TABLE_TYPE = 'BASE TABLE' " + 
                "ORDER BY TABLE_TYPE", cnn);
        //
        da.Fill(dt);
        if( nombreTabla == null)
            nombreTabla = "Prueba";
        foreach(DataRow dr in dt.Rows){
            if( dr["TABLE_NAME"].ToString() == nombreTabla ){
                return true;
            }
        }
        //
        return existe;
 
    }
    catch(Exception ex){
        MessageBox.Show("ERROR: " + ex.Message, "Comprobar tabla");
        return false;
    }
}

 

 

El método para crear la tabla de ejemplo (Prueba)

private bool crearTablaPrueba() {
    // Crear la tabla de prueba en la base e instancias seleccionadas
    // Devuelve true si todo fue bien
    bool creada = false;
    string sCnn = "Server=" + cboInstancias.Text + "; database=" + cboBases.Text + "; integrated security=yes";
    string sCmd = "CREATE TABLE [dbo].[Prueba]( " + 
                "[ID] [int] IDENTITY(1,1) NOT NULL, " + "[Nombre] [nvarchar](50) COLLATE Modern_Spanish_CI_AS NULL," + 
                "[e-mail] [nvarchar](128) COLLATE Modern_Spanish_CI_AS NULL," + 
                "[FechaAlta] [datetime] NULL," + "[Comentario] [nvarchar](2048) COLLATE Modern_Spanish_CI_AS NULL," + 
                "CONSTRAINT [PK_Prueba] PRIMARY KEY CLUSTERED (" + 
                "[ID] ASC)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY])" + 
                " ON [PRIMARY]";
    SqlConnection cnn = null;
    try{
        cnn = new SqlConnection(sCnn);
        cnn.Open();
        SqlCommand cmd = new SqlCommand(sCmd, cnn);
 
        cmd.ExecuteNonQuery();
        creada = true;

    }
    catch(Exception ex){
        MessageBox.Show("Error al crear la tabla:\n" + ex.Message);

    }
    finally{
        if( cnn != null ){
            if( cnn.State == ConnectionState.Open ){
                cnn.Close();
            }
        }
    }
 
    return creada;
}

 

 

Añadir nuevos registros

Para añadir nuevos registros, lo primero que tenemos que hacer es crear una nueva fila.
Para ello utilizamos el método NewRow del objeto DataTable.

Al usar ese método, nos aseguramos que la nueva fila creada tiene todos los datos sobre la estructura de la tabla (o de la selección que hemos hecho), de forma que podamos asignar los campos, etc.

La asignación de los campos la hacemos mediante el método asignarDatos, aunque podríamos haberlo hecho directamente.
El hacerlo mediante ese método es para que nos resulte más cómo adaptar este ejemplo a otra tabla diferente a la que yo propongo, ya que en ese método haríamos todas las asignaciones que debamos hacer, salvo la del campo ID ya que al ser autonumérico no podemos asignarle un valor, porque ese valor lo asignará automáticamente ADO.NET.

Una vez que la fila tiene asignados los valores de los campos, la añadimos a las fila de la tabla. Esto es necesario, ya que el método NewRow solo crea una fila, pero no la "relaciona" (o añade) a la tabla actual.

Finalmente actualizamos los datos mediante el método Update del adaptador.
En realidad no hace falta hacer esa actualización en este preciso momento, pero si no lo hacemos, debemos añadir otro botón para que los datos se asignen a la base de datos, ya que al añadir un nuevo valor a la tabla, lo haremos en la "copia" que tenemos localmente en memoria, y no directamente en la base de datos, como ocurría, por ejemplo, con VB6 y los Recordsets.

Una vez actualizados los datos en la base de datos, le indicamos a la tabla que acepte los cambios que hayamos hecho, de forma que quede sincronizada nuevamente.
Esto es necesario, ya que si no lo hacemos, la tabla mantendrá los cambios que hayamos hecho y si nuevamente "sincronizamos" esos datos con la base real, se podrían producir errores.

Es importante que sepamos que cuando llamamos al método Update del adaptador, se realizan todas las actualizaciones, es decir, no solo añadir nuevos datos, como "se supone" que es lo que hace este método, sino que si hubiésemos eliminado filas, o modificado algunas, esas modificaciones también se reflejarían en la base de datos.

Debido a cómo funcionan los campos autincrementales, para asegurarnos de que en realidad el valor de ese ID se actualiza correctamente, si es el primer registro que añadimos (o vale cero, como es la comprobación que hacemos aquí), deberíamos volver a leer los datos reales de la base de datos (que será después de haber añadido el primer registro) con idea de que ese ID tenga el valor correcto. Esto no es necesario en los siguientes datos que vayamos añadiendo, ya que en otros casos el valor del ID se asignará correctamente.

Como ves, también controlamos los errores que se puedan producir... ¡nunca está de más!

private void btnNuevo_Click(object sender, EventArgs e) {
    // Crear un nuevo registro
    DataRow dr = dt.NewRow();
    // Asignar los datos de los textbox a la fila
    asignarDatos(dr);
 
    // Añadir la nueva fila a la tabla
    dt.Rows.Add(dr);
    // Guardar físicamente los datos en la base
    try{
        da.Update(dt);
        dt.AcceptChanges();
        // Si es el primer registro de la base,
        // volver a leer los datos para actualizar los IDs
        if( Convert.ToInt32("0" + dr["ID"].ToString()) == 0 ){
            dt = new DataTable();
            da.Fill(dt);
        }
        // Posicionarlo en la última fila
        btnLast_Click(null, null);
    }catch(DBConcurrencyException ex){
        MessageBox.Show("Error de concurrencia:\n" + ex.Message);
    }catch(Exception ex){
        MessageBox.Show(ex.Message);
    }
}

Si la caja de textos para la fecha no tiene nada, usamos un valor "nulo" para asignar a ese campo.
De todas formas, deberíamos usar un try/catch para comprobar que la fecha asignada es válida.

private void asignarDatos(DataRow dr) {
    // Usar los datos que hay en los textbox
    dr["Nombre"] = txtNombre.Text;
    dr["e-mail"] = txtEmail.Text;
    if( txtFechaAlta.Text == "" ){
        dr["FechaAlta"] = DBNull.Value;
    }
    else{
        dr["FechaAlta"] = txtFechaAlta.Text;
    }
    dr["Comentario"] = txtComentario.Text;
}

 

 

Actualizar los registros modificados

La actualización de los datos, es decir, cuando modificamos un registro (o fila) y queremos que esos datos se guarden, es muy simple. En el código del método de actualizar, primero comprobamos que el valor de la variable fila sea válido, es decir, esté dentro del rango de filas que tiene el DataTable.

Si es así, asignamos a una variable del tipo DataRow la fila en cuestión y posteriormente llamamos al método asignarDatos que vimos antes, que como sabes es el que se encarga de asignar las cajas de texto a los campos correspondientes.

Una vez que la fila tiene los nuevos datos, volvemos a llamar al método Update del adaptador, como comenté antes, esta llamada al método Update solo es necesario si queremos asignar directamente los datos en la base, es decir, hacer que los cambios se hagan en ese preciso momento.

También encerramos esa actualización dentro de un Try/Catch para detectar los errores que se puedan producir.

private void btnActualizar_Click(object sender, EventArgs e) {
    // Actualizar los datos en la fila actual
    if( fila < 0 || fila > dt.Rows.Count - 1 ) return;
 
    DataRow dr = dt.Rows[fila];
    // Asignar los datos de los textbox a la fila
    asignarDatos(dr);
 
    try{
        da.Update(dt);
        dt.AcceptChanges();
    }catch(DBConcurrencyException ex){
        MessageBox.Show("Error de concurrencia:\n" + ex.Message);
    }catch(Exception ex){
        MessageBox.Show(ex.Message);
    }
}

 

 

Eliminar el registro actual

Una vez que tenemos un registro mostrado, podemos pulsar en el botón Eliminar, para hacerlo, usamos el método Delete de la fila indicada y a continuación le indicamos al adaptador que actualice los datos físicamente en la base y a la tabla le tenemos que indicar que acepte los cambios, con idea de que esa fila que hemos eliminado, la elimine también de la memoria.

Cuando eliminamos un registro, en nuestro programa se dejan los datos, de forma que si nos arrepentimos, podamos volver a crearlos, no recuperarlos, sino crear un registro nuevo, con su nuevo ID, etc.

private void btnEliminar_Click(object sender, EventArgs e) {
    // Eliminar la fila actual
    if( fila < 0 || fila > dt.Rows.Count - 1 ) return;
 
    try{
        // Eliminar la fila de la tabla
        dt.Rows[fila].Delete();
        // Actualizar físicamente la base de datos
        da.Update(dt);
        // Aceptar los cambios en la copia local
        dt.AcceptChanges();
    }catch(DBConcurrencyException ex){
        MessageBox.Show("Error de concurrencia:\n" + ex.Message);
    }catch(Exception ex){
        MessageBox.Show(ex.Message);
    }
 
}

 

Nota:
Si lo que realmente te interesa es que los datos NO se eliminen directamente en la base de datos, (ni se actualicen ni creen nuevos), hasta que tu quieras, la llamada al método Update del adaptador y la llamada al método AcceptChanges de la tabla no deberías llamarla en estos tres métodos que acabamos de ver, sino que puedes hacerlo, por ejemplo, cuando el usuario "realmente" quiera que todos esos cambios se hagan físicamente en la base de datos.
Pero eso es, como siempre, a tu criterio.

 

 

Moverse entre registros, con comandos para ir al primero, al último, al anterior y al siguiente

Para movernos entre los registros usaremos cuatro métodos, uno para ir al principio, otro para ir al final, otro para ir al registro anterior y otro para el siguiente.

En estos cuatro métodos usaremos un método extra que será el que se encargue de comprobar si todo está correcto (o casi) y de mostrar los datos adecuados en cada caja de texto. Al igual que antes con el método asignarDatos, lo he puesto por separado, entre otras cosas para facilitar la modificación del código para otras tablas.

También para que no haya que estar repitiendo en el resto de los métodos las comprobaciones de que el valor de fila indicado está dentro del rango válido. Ese rango debe estar entre cero para el primer registro y uno menos del número total de filas para el último, por tanto, si el valor del número de la fila indicado no es correcto, no hacemos nada, simplemente salimos del método.

En caso de que sigamos, quiere decir que es un valor de fila correcto, por tanto leemos esa fila (asignándola a una variable de tipo DataRow) y asignamos los valores a las cajas de texto, en este caso si que usamos el valor del campo ID con idea de que veamos ese valor.

Por último habilitamos el botón de actualizar y eliminar, ya que se supone que hay datos.

private void mostrarDatos(int f) {
    int uf = dt.Rows.Count - 1;
    if( f < 0 || uf < 0 ) return;
    //
    DataRow dr = dt.Rows[f];
    txtID.Text = dr["ID"].ToString();
    txtNombre.Text = dr["Nombre"].ToString();
    txtEmail.Text = dr["e-mail"].ToString();
    txtFechaAlta.Text = dr["FechaAlta"].ToString();
    txtComentario.Text = dr["Comentario"].ToString();
    //
    btnActualizar.Enabled = true;
    btnEliminar.Enabled = true;
}

 

Los cuatro métodos para movernos son los siguientes, veamos que es lo que hacemos en cada uno de ellos, aunque creo que viendo el código queda clara la intención.

Nota:
Como veremos en el código, en realidad no hace falta pasarle ningún parámetro al método mostrarDatos, ya que al tener la variable fila disponible en todo el formulario, podríamos usar esa variable en lugar del parámetro, pero... lo dejo así por si se te ocurre hacer cambios y no usar esa variable, que hay gente que no le gusta usar variables "globales" al formulario o clase...

 

Para ir al primero, simplemente asignamos cero a la variable de la fila actual y llamamos al método de mostrar los datos.

private void btnFirst_Click(object sender, EventArgs e) {
    // Posicionarse en la primera fila
    fila = 0;
    // Mostrar los datos de la fila indicada
    mostrarDatos(fila);
}

Para ir al último, averiguamos cual es la última fila, que como vemos es el valor devuelto por la propiedad Count de la colección de filas (Rows), menos uno, ya que como sabemos todos los arrays y colecciones de .NET siempre empiezan con el índice cero.

private void btnLast_Click(object sender, EventArgs e) {
    // Posicionarse en la última fila
    fila = dt.Rows.Count - 1;
    // Mostrar los datos de la fila indicada
    mostrarDatos(fila);
}

Para ir al anterior simplemente le restamos uno al valor de la fila actual, pero debemos hacer una comprobación de que no sea menor de cero, ya que es posible que estemos en el primer registro y pulsemos en el botón de ir al anterior. En caso de que estemos en el primero, seguiremos en ese mismo registro.

private void btnPrev_Click(object sender, EventArgs e) {
    // Posicionarse en la fila anterior
    fila = fila - 1;
    if( fila < 0 ) fila = 0;
    // Mostrar los datos de la fila indicada
    mostrarDatos(fila);
}

Por último, para ir al siguiente, hacemos lo mismo que antes, pero en lugar de restar uno, lo que hacemos es añadir uno al valor de la fila actual, y en el caso de que sea mayor que la última fila, pues nos quedamos en esa última fila.

private void btnNext_Click(object sender, EventArgs e) {
    // Posicionarse en la fila siguiente
    int uf = dt.Rows.Count - 1;
    fila = fila + 1;
    if( fila > uf ) fila = uf;
    // Mostrar los datos de la fila indicada
    mostrarDatos(fila);
}

 

 

Link al código de ejemplo

Aquí tienes los links al código de ejemplo para Visual C#. El proyecto está creado con Visual Studio 2003, pero funcionará igualmente en la versión 2005 y con cambios menores, también en la versión 2002.

El código para Visual C#: ejemploDatosSQLCS.zip  - 11.00 KB

(MD5 checksum: 9ADF5E65CA151BE0B1045C61B6E1985A)


Ir al índice principal de el Guille