Introducción
He visto en reiteradas oportunidad que una operación simple como es el caso de operar con una fila de un GridView se puede transformarse en algo complejo, mas que nada motivado por la distintas formas que hay para realizar esta acción.
En este articulo veremos las algunas formas de lograrlo y como difieren las técnicas que se puede aplicarse.
Temas que se tratar:
1- Seleccionar una Row
a- Definiendo un CommandField
b- Usando un ImageButton y CommandName
c- Usando el evento RowCommand
2-Uso de DataKeyNames y DataKeys
a- DataKeyNames con campos Múltiples
Para todos los casos planteados partiremos del mismo gridview, el cual se ira modificando para agregarle opciones y ver los distintos temas.
1- Seleccionar una Row
Existen varias formas de realizar una misma tarea, pero veremos aquí las dos mas simples y directas que se suelen encontrar cuando se necesita seleccionar un registro en el control gridview.
1a- Definiendo un CommandField
Iremos realizando los paso de forma visual así se comprende como proceder, remarcando luego como impacta esto en el html del grid
El primer paso será editar las columnas del GridView hasta visualizar el cuadro con las opciones de CommandField disponibles.
Para este caso en particular se agregara solo la opción de selección. Mediante las flechas laterales se puede posicionar el comando. También se dispone de distintos tipos de representación visual, como ser un Link, Button o Image.
Para este caso usaremos un comando del tipo Image, por lo tanto se deberá definir la propiedad “SelectImageUrl”. Si se define del tipo Link y se quiere cambiar el texto, se usaría la propiedad “SelectText”.
El próximo paso será el de definir el evento de selección, para esto solo marcamos el gridview, y yendo a sus propiedades se podrá activar el evento SelectedIndexChanged
El html resultante debería tener resaltadas las siguiente características
Con estos pasos ya estamos listos para capturar la acción de selección del gridview.
1b - Usando un ImageButton y CommandName
En esta alternativa se hará uso de un TemplateField, se procede de la misma forma del paso 1a, pero se agrega un item diferente
Una vez que esta el témplate, se adapta modificando directamente en el html, incluyendo de esta forma el control ImageButton.
Es muy importante remarcar que el ImageButton deberá tener la propiedad CommandName=”Select” para que esta ejecute el evento SelectedIndexChanged
A nivel de código de la pagina se encontrara la definición del evento
Hay que aclarar que en este caso se uso un ImageButton para corresponder con la acción del punto 1a, en donde se define una imagen, pero si se requiere de un link solo será cuestión de usar un LinkButton, definiendo en este el CommandName=”Select”, es justamente el CommandName quien define que evento será lanzado al presionarse.
1c- Usando el evento RowCommand
Seguramente a estas alturas se preguntaran que cantidad de formas de hacer lo mismo, asi es, y para completarlo una opción extra.
Resulta que al definir un ImageButton (o LinkButton) en un TemplateItem y usar el CommandName=”Select” se habilita un evento adicionar para poder capturar esta acción, si es que el SelectedIndexChanged no nos convence.
Se trata del evento RowCommand.
Hay un pequeño detalle con este evento y se trata de la definición del CommandArgument para determinar que fila lanza la acción.
[C#]
protected void gvPerson_RowCommand(object sender, GridViewCommandEventArgs e)
{
if (e.CommandName == "Select")
{
//
// Se obtiene indice de la row seleccionada
//
int index = Convert.ToInt32(e.CommandArgument);
//
// Obtengo el id de la entidad que se esta editando
// en este caso de la entidad Person
//
int id = Convert.ToInt32(gvPerson.DataKeys[index].Value);
}
}
[VB.NET]
Protected Sub gvPerson_RowCommand(sender As Object, e As GridViewCommandEventArgs)
If e.CommandName = "Select" Then
'
' Se obtiene indice de la row seleccionada
'
Dim index As Integer = Convert.ToInt32(e.CommandArgument)
'
' Obtengo el id de la entidad que se esta editando
' en este caso de la entidad Person
'
Dim id As Integer = Convert.ToInt32(gvPerson.DataKeys(index).Value)
End If
End Sub
En el ejemplo de la pagina WebForm4.aspx, se podrá probar como ambos eventos, tanto el RowCommand y el SelectedIndexChanged, pueden definirse, aunque lo normal es utilizar solo uno de estos.
2 - Uso de DataKeyNames y DataKeys
Una de las mejores técnicas usada para detectar que entidad se esta editando o seleccionado es por medio de id o código que esta tenga asignada, pero como logar hacerlo sin mostrar el identificador al usuario en una columna ?, es justamente el trabajo de estas dos propiedades que se consigue resolver el problema.
Si se presta atención al html este contaba con al definición de esta propiedad de nombre DataKeyNames
Solo debe definirse que campo del origen de datos identifica a la entidad que se esta trabajando.
Cuando se lance el evento solo será cuestión de tomar la row que ejecuta la acción, y de esta, por el índice recuperar el valor del id de la entidad, en este caso el PersonID.
[C#]
protected void gvPerson_SelectedIndexChanged(object sender, EventArgs e)
{
//
// Se obtiene la fila seleccionada del gridview
//
GridViewRow row = gvPerson.SelectedRow;
//
// Obtengo el id de la entidad que se esta editando
// en este caso de la entidad Person
//
int id = Convert.ToInt32(gvPerson.DataKeys[row.RowIndex].Value);
}
[VB.NET]
Protected Sub gvPerson_SelectedIndexChanged(sender As Object, e As EventArgs) ' ' Se obtiene la fila seleccionada del gridview ' Dim row As GridViewRow = gvPerson.SelectedRow ' ' Obtengo el id de la entidad que se esta editando ' en este caso de la entidad Person ' Dim id As Integer = Convert.ToInt32(gvPerson.DataKeys(row.RowIndex).Value) End Sub
2a- DataKeyNames con campos Múltiples
En este ejemplo solo se utilizo un valor simple para identificar a la entidad, pero el CommandName puede definir mas de un campo de información.
Por ejemplo que sucede si se quiere enviar el PersonId y el Nombre, esto es tan solo un ejemplo para demostrar las funcionalidad, no tiene una aplicación práctica en este caso, ya que con solo el PersonID seria mas que suficiente.
Para definir el DataKeyNames en el grid es tan simple como separar los campos por una coma.
y en el código solo se toma el valor de la propiedad Values
[C#]
protected void gvPerson_SelectedIndexChanged(object sender, EventArgs e)
{
//
// Se obtiene la fila seleccionada del gridview
//
GridViewRow row = gvPerson.SelectedRow;
//
// Obtengo el id y el nombre de la entidad que se esta editando
// en este caso de la entidad Person
//
int id = Convert.ToInt32(gvPerson.DataKeys[row.RowIndex].Values["PersonID"]);
string nombre = Convert.ToString(gvPerson.DataKeys[row.RowIndex].Values["FirstName"]);
}
[VB.NET]
Protected Sub gvPerson_SelectedIndexChanged(sender As Object, e As EventArgs)
'
' Se obtiene la fila seleccionada del gridview
'
Dim row As GridViewRow = gvPerson.SelectedRow
'
' Obtengo el id y el nombre de la entidad que se esta editando
' en este caso de la entidad Person
'
Dim id As Integer = Convert.ToInt32(gvPerson.DataKeys(row.RowIndex).Values("PersonID"))
Dim nombre As String = Convert.ToString(gvPerson.DataKeys(row.RowIndex).Values("FirstName"))
End Sub
Ejemplo Código
Para el ejemplo se hizo uso de Visual Studio 2008 con SP1, el service pack es útil para poder hacer uso de Entity Framework y poder crear el ADO.NET Entity Data Model haciendo simple el acceso a la db.
La base de datos es Sql Server 2008 Express R2, y se encuentra el mdf dentro de la carpeta App_Data, pero se podría adjuntar al servicio de Sql Server o hacer uso del script que se encuentra en el proyecto de DataAccess.
