Guía de DataGrid en VB.NET con ADO.NET
Guía de DataGrid en VB.NET con ADO.NET
DataGrid
Este control, del que ya realizamos una pequea demostracin en un apartado anterior, nos va a permitir realizar enlace complejo de datos con ADO .NET. Se trata de la versin mejorada del control DataGrid de ADO, disponible en Visual Basic 6, pero con una serie de funcionalidades optimizadas, y otras nuevas aadidas. Para utilizar algunas de sus caractersticas, crearemos un proyecto de prueba con el nombre DataGridPru (hacer clic aqu para acceder a este ejemplo), consistente en un formulario MDI, con una serie de opciones de men, a travs de las cuales, mostraremos diversas caractersticas de este control, y algunas otras adicionales sobre ADO .NET. La opcin de men DataGrid + Normal, mostrar el formulario frmNormal, que contiene un sencillo DataGrid con una tabla. Podemos editar los registros de la tabla y aadir nuevos; al trabajar en desconexin, hasta que no pulsemos el botn Actualizar de este formulario, el objeto DataAdapter del mismo no actualizar los datos del DataSet hacia la base de datos fsica. Otra caracterstica incluida por defecto es la ordenacin de las filas por columna al hacer clic en su ttulo. Finalmente, al redimensionar el formulario, tambin cambiar el tamao del DataGrid, puesto que hemos utilizado su propiedad Anchor para anclarlo a todos los bordes de la ventana. La Figura 350 muestra este formulario.
El Cdigo fuente 582 muestra el cdigo principal de este formulario. Recordamos al lector, la necesidad de crear un objeto CommandBuilder para el DataAdapter, ya que en caso contrario, al intentar actualizar el DataSet contra la base de datos, se producir un error.
Pgina 1
Pgina 2
En el siguiente paso, abriremos el Cuadro de herramientas, y pulsaremos la ficha Data, aadiendo al formulario un control SqlDataAdapter, lo que abrir un asistente para la configuracin de este control. Ver Figura 352. Tras la ventana de presentacin, al pulsar el botn Siguiente, deberemos elegir la conexin que el adaptador utilizar. Ver Figura 353.
Pgina 3
Pgina 4
A continuacin seleccionaremos el tipo de consulta, en este caso una sencilla sentencia SQL. Ver Figura 354.
Continuaremos con la escritura de la sentencia SQL que quedar incluida en el DataAdapter. Ver Figura 355.
Pgina 5
Como paso final, se muestra un resumen de lo que este asistente ha generado en el DataAdapter. Figura 356.
Pgina 6
Finalizada la creacin del adaptador de datos, seleccionaremos el men Datos + Generar conjunto de datos del IDE, que nos mostrar una ventana en la que daremos el nombre del DataSet que utilizar el formulario, y nos permitir elegir las tablas que contendr. Ver Figura 357.
Pgina 7
A continuacin dibujaremos un DataGrid en el formulario, y pasaremos a su ventana de propiedades. En la propiedad DataSource asignaremos el DataSet que acabamos de crear, mientras que en la propiedad DataMember, seleccionaremos la tabla del DataSet que va a mostrar el DataGrid. Ver Figura 358.
Completado este ltimo paso, el DataGrid mostrar en tiempo de diseo, la disposicin de las columnas de la tabla en su interior. Ver Figura 359.
Figura 359. DataGrid mostrando informacin de las columnas de la tabla del DataSet.
En cuanto al cdigo que debemos escribir, en el evento Load, inicializaremos el DataSet, rellenndolo a continuacin mediante el DataAdapter. Ver Cdigo fuente 583.
Private Sub frmGridAsist_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load Me.DsMusica1.Clear() Me.SqlDataAdapter1.Fill(Me.DsMusica1) End Sub Cdigo fuente 583
Podremos ver este formulario en ejecucin al seleccionar en el formulario principal del ejemplo, el men DataGrid + Asistente.
Pgina 8
' crear conexin Dim oConexion As New SqlConnection() oConexion.ConnectionString = "Server=(local);" & _ "Database=Musica;uid=sa;pwd=;" ' crear adaptador oDataAdapter = New SqlDataAdapter("SELECT * FROM Grabaciones", oConexion) ' crear commandbuilder Dim oCB As SqlCommandBuilder = New SqlCommandBuilder(oDataAdapter) ' crear dataset oDataSet = New DataSet() oDataAdapter.Fill(oDataSet, "Grabaciones") ' asignar dataset al datagrid Me.grdDatos.DataSource = oDataSet Me.grdDatos.DataMember = "Grabaciones" ' configurar grid por cdigo Me.grdDatos.Anchor = AnchorStyles.Bottom + AnchorStyles.Left + AnchorStyles.Right + AnchorStyles.Top Me.grdDatos.CaptionText = "El listado de las grabaciones" Me.grdDatos.CaptionBackColor = Color.Turquoise Me.grdDatos.CaptionForeColor = Color.Black ' crear un objeto para estilos del datagrid Dim oEstiloGrid As New DataGridTableStyle() oEstiloGrid.MappingName = "Grabaciones" oEstiloGrid.BackColor = Color.LightGoldenrodYellow oEstiloGrid.AlternatingBackColor = Color.Aquamarine ' crear objetos de columna-grid para cada ' columna de la tabla a mostrar en el datagrid Dim oColGrid As DataGridTextBoxColumn ' configurar cada objeto de columna-grid oColGrid = New DataGridTextBoxColumn() oColGrid.TextBox.Enabled = False oColGrid.Alignment = HorizontalAlignment.Center oColGrid.HeaderText = "Descripcin grabac." ' nombre de la columna del dataset que ' se mapea hacia esta columna del grid oColGrid.MappingName = "Titulo" oColGrid.Width = 300 ' aadir la columna al objeto que contiene ' los estilos del datagrid, en concreto, ' a la coleccin de estilos de columna oEstiloGrid.GridColumnStyles.Add(oColGrid) oColGrid = Nothing oColGrid = New DataGridTextBoxColumn() oColGrid.TextBox.Enabled = False oColGrid.Alignment = HorizontalAlignment.Left oColGrid.HeaderText = "Fecha COMPRA" oColGrid.MappingName = "FCompra"
Pgina 10
oColGrid.Width = 85 oColGrid.Format = "#,#" oEstiloGrid.GridColumnStyles.Add(oColGrid) oColGrid = Nothing ' una vez creadas todas las columnas de ' estilos para el grid, aadir el objeto ' que contiene el estilo personalizado ' a la coleccin de estilos de tablas ' del datagrid Me.grdDatos.TableStyles.Add(oEstiloGrid) End Sub Cdigo fuente 584
Private Sub frmGridTablas_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load ' crear conexin Dim oConexion As New SqlConnection() oConexion.ConnectionString = "Server=(local);" & _
"Database=Musica;uid=sa;pwd=;" ' crear adaptadores Dim oDAAutores As New SqlDataAdapter("SELECT * FROM Autores", oConexion) Dim oDAGrabaciones As New SqlDataAdapter("SELECT * FROM Grabaciones", oConexion) ' crear dataset Dim oDataSet As New DataSet() oDAAutores.Fill(oDataSet, "Autores") oDAGrabaciones.Fill(oDataSet, "Grabaciones") ' asignar dataset a datagrid Me.grdDatos.DataSource = oDataSet End Sub Cdigo fuente 585
Como al asignar el DataSet al DataGrid no hemos indicado qu tabla queremos que muestre, el DataGrid en el formulario visualizar un nodo que al expandir, nos permitir seleccionar la tabla a mostrar. Podremos contraer dicha tabla para seleccionar otra, y as sucesivamente. Ver Figura 362.
Pgina 12
Al seleccionar un valor del ComboBox, se tomarn las filas relacionadas de la tabla Orders y se llenar con ellas un ListBox. El cdigo necesario podemos verlo en el Cdigo fuente 586.
Private Sub frmManual_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load ' crear conexin Dim oConexion As New SqlConnection() oConexion.ConnectionString = "server=(local);" & _ "database=Northwind;uid=sa;pwd=;" ' crear adaptadores Dim daCustomers As New SqlDataAdapter("SELECT * FROM Customers", oConexion) Dim daOrders As New SqlDataAdapter("SELECT * FROM Orders", oConexion) ' instanciar dataset oDataSet = New DataSet() oConexion.Open() ' utilizar los dataadapters para llenar el dataset con tablas daCustomers.Fill(oDataSet, "Customers") daOrders.Fill(oDataSet, "Orders") oConexion.Close() ' relacionar las dos tablas del dataset por campo comn oDataSet.Relations.Add("Customers_Orders", _ oDataSet.Tables("Customers").Columns("CustomerID"), _ oDataSet.Tables("Orders").Columns("CustomerID")) ' llenar el combobox con los nombres de cliente Dim oDataRow As DataRow For Each oDataRow In oDataSet.Tables("Customers").Rows Me.cboCustomers.Items.Add(oDataRow("CustomerID") & _ "-" & oDataRow("CompanyName")) Next
Pgina 13
Pgina 14
' relacionar las dos tablas del dataset por campo comn oDataSet.Relations.Add("Customers_Orders", _ oDataSet.Tables("Customers").Columns("CustomerID"), _ oDataSet.Tables("Orders").Columns("CustomerID")) ' asignar la tabla maestra al datagrid Me.grdDatos.DataSource = oDataSet.Tables("Customers") Cdigo fuente 587
Al abrir este formulario, se visualizarn los datos de la tabla maestra Customers. Cada fila contiene un nodo expandible, que al ser pulsado muestra la relacin existente. Si volvemos a hacer clic sobre la relacin, se mostrarn en este caso las filas hijas de la tabla Orders, relacionadas con la que hemos seleccionado en la tabla padre. Ver Figura 364 y Figura 365. En todo momento, desde la vista de las tablas hijas, podemos volver a la vista de la tabla padre, haciendo clic en el icono con forma de flecha situado en el ttulo del DataGrid.
Pgina 15
' relacionar las dos tablas del dataset por campo comn oDataSet.Relations.Add("Customers_Orders", _ oDataSet.Tables("Customers").Columns("CustomerID"), _ oDataSet.Tables("Orders").Columns("CustomerID")) ' asignar al datagrid maestro la tabla Customers Me.grdCustomers.DataSource = oDataSet Me.grdCustomers.DataMember = "Customers" ' asignar al datagrid detalles la relacin
' que acabamos de crear por cdigo Me.grdOrders.DataSource = oDataSet Me.grdOrders.DataMember = "Customers.Customers_Orders" Cdigo fuente 588
La Figura 366 muestra el formulario con ambos DataGrid trabajando en modo conjunto; al hacer clic en una fila del DataGrid maestro, el DataGrid detalle se actualizar con los datos relacionados. LECCION 7 El control DataGrid Pgina 16
' relacionar las dos tablas del dataset por campo comn oDataSet.Relations.Add("Customers_Orders", _ oDataSet.Tables("Customers").Columns("CustomerID"), _ oDataSet.Tables("Orders").Columns("CustomerID")) ' asignar al datagrid maestro la tabla Customers Me.grdCustomers.DataSource = oDataSet Me.grdCustomers.DataMember = "Customers" ' asignar al segundo datagrid maestro la tabla Customers Me.grdCustomersB.DataSource = oDataSet Me.grdCustomersB.DataMember = "Customers"
' asignar al datagrid detalles la relacin ' que acabamos de crear por cdigo Me.grdOrders.DataSource = oDataSet Me.grdOrders.DataMember = "Customers.Customers_Orders"
Pgina 17
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load ' crear conexin Dim oConexion As New SqlConnection() oConexion.ConnectionString = "Server=(local);" & _ "Database=Northwind;uid=sa;pwd=;"
Pgina 18
'crear dataset oDataSet = New DataSet() Dim oDataAdapter As SqlDataAdapter ' crear un adaptador de datos para la tabla Customers oDataAdapter = New SqlDataAdapter("SELECT * FROM Customers", oConexion) ' aadir tabla al dataset con el adaptador oDataAdapter.Fill(oDataSet, "Customers") oDataAdapter = Nothing ' crear un adaptador de datos para la tabla Products oDataAdapter = New SqlDataAdapter("SELECT * FROM Products", oConexion) ' aadir tabla al dataset con el adaptador oDataAdapter.Fill(oDataSet, "Products") oDataAdapter = Nothing End Sub Cdigo fuente 590
Private Sub mnuNormal_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles mnuNormal.Click ' crear una vista por cdigo y asignarla ' a un datagrid Dim dvNormal As DataView dvNormal = New DataView(oDataSet.Tables("Customers")) Me.grdDatos.CaptionText = "Customers" Me.grdDatos.DataSource = dvNormal ' tomar la vista por defecto de una tabla ' del dataset y asignarla a un datagrid Me.grdDatosBIS.CaptionText = "Products" Me.grdDatosBIS.DataSource = oDataSet.Tables("Products").DefaultView End Sub Cdigo fuente 591
Pgina 19
Private Sub mnuPais_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles mnuPais.Click ' crear dataview Dim oDataView As New DataView() oDataView.Table = oDataSet.Tables("Customers") ' establecer un filtro oDataView.RowFilter = "Country='Spain'" Me.grdDatos.CaptionText = "Filtrar Customers por pas Spain" Me.grdDatos.DataSource = oDataView End Sub Cdigo fuente 592
La Figura 369 muestra las filas de la tabla con el filtro aplicado. LECCION 7 El control DataGrid Pgina 20
Como hemos comentado anteriormente, a partir de un DataTable podemos obtener varios filtros mediante distintos objetos DataView, sin que ello suponga una penalizacin en el consumo de recursos. Para demostrar este punto, la opcin Vistas + Combinada, crea una vista basada en un filtro combinado, y una vista normal, ambas empleando la misma tabla base. Veamos el Cdigo fuente 593.
Private Sub mnuCombinada_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles mnuCombinada.Click ' tomar la tabla Customers del dataset y aplicar... ' ...filtro combinado por dos campos y depositar en un datagrid Dim oDataView As New DataView() oDataView.Table = oDataSet.Tables("Customers") oDataView.RowFilter = "ContactTitle LIKE '%Manager%' AND Country IN ('Spain','USA')" Me.grdDatos.CaptionText = "Filtro combinado por campos ContactTitle y Country" Me.grdDatos.DataSource = oDataView ' ...filtro por un campo y depositar en otro datagrid Dim oDV As New DataView() oDV.Table = oDataSet.Tables("Customers") oDV.RowFilter = "ContactName LIKE '%an%'" Me.grdDatosBIS.CaptionText = "Filtro por campo ContactName" Me.grdDatosBIS.DataSource = oDV End Sub Cdigo fuente 593
Pgina 21
Private Sub mnuBuscarFila_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles mnuBuscarFila.Click ' crear un dataview y buscar una fila en la vista ' estableciendo un filtro Dim oDataView As New DataView() oDataView.Table = oDataSet.Tables("Customers") oDataView.RowFilter = "CustomerID = '" & Me.txtCustomerID.Text & "'" Me.grdDatosBIS.CaptionText = "Buscar ID cliente: " & Me.txtCustomerID.Text Me.grdDatosBIS.DataSource = oDataView End Sub Cdigo fuente 594
En la Figura 371 vemos el resultado de una bsqueda, mostrado en uno de los DataGrid del formulario.
Pgina 22
Figura 371. Bsqueda de una fila en una tabla de un DataSet, empleando un DataView.
Private Sub mnuOrdNormal_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles mnuOrdNormal.Click ' crear dataview y ordenar las filas ' con la propiedad Sort Dim oDataView As New DataView() oDataView.Table = oDataSet.Tables("Customers") oDataView.Sort = "Country" Me.grdDatos.CaptionText = "Ordenar por campo Country" Me.grdDatos.DataSource = oDataView End Sub Cdigo fuente 595
Veamos el resultado al ejecutar en la Figura 372. Si necesitamos ordenar por mltiples columnas de la tabla, slo tenemos que asignar a Sort una cadena con la LECCION 7 El control DataGrid Pgina 23
Tambin es factible asignar a un DataView una combinacin de filtro y ordenacin, utilizando en la misma operacin las propiedades RowFilter y Sort. El men del formulario Ordenacin + Con filtro realiza este trabajo, que vemos en el Cdigo fuente 597.
Private Sub mnuOrdenFiltro_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles mnuOrdenFiltro.Click Dim oDataView As New DataView() oDataView.Table = oDataSet.Tables("Customers") ' establecer un filtro al dataview oDataView.RowFilter = "Country='USA'" ' ordenar las filas del filtro oDataView.Sort = "City" Me.grdDatos.CaptionText = "Filtrar por USA. Ordenar por campo City" Me.grdDatos.DataSource = oDataView End Sub Cdigo fuente 597
Los datos con el filtro y orden podemos verlos en el DataGrid del formulario, que muestra la Figura 373.
Pgina 24
Private Sub btnEsquema_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles btnEsquema.Click ' crear conexin Dim oConexion As New SqlConnection() oConexion.ConnectionString = "Server=(local);" & _ "Database=Northwind;uid=sa;pwd=;" ' crear dataset Dim oDataSet As New DataSet() ' crear adaptadores de datos para las tablas ' y aadir cada tabla al dataset con el adaptador Dim oDataAdapter As SqlDataAdapter oDataAdapter = New SqlDataAdapter("SELECT * FROM Customers", oConexion) oDataAdapter.Fill(oDataSet, "Customers") oDataAdapter = Nothing oDataAdapter = New SqlDataAdapter("SELECT * FROM Orders", oConexion) oDataAdapter.Fill(oDataSet, "Orders") oDataAdapter = Nothing
Pgina 25
oDataAdapter.Fill(oDataSet, "Territories") oDataAdapter = Nothing ' crear un objeto tabla y columna para mostrar ' la informacin del esquema que el dataset contiene Dim oDataTable As DataTable Dim oDataColumn As DataColumn Me.lstEsquema.Items.Add("Estructura del DataSet") ' recorrer la coleccin de tablas del DataSet For Each oDataTable In oDataSet.Tables Me.lstEsquema.Items.Add("Tabla: " & oDataTable.TableName)
Next ' recorrer la coleccin de columnas de la tabla For Each oDataColumn In oDataTable.Columns Me.lstEsquema.Items.Add("Campo: " & _ oDataColumn.ColumnName & " --- " & _ "Tipo: " & oDataColumn.DataType.Name) Next End Sub Cdigo fuente 598
La Figura 374 muestra el ListBox relleno con el esquema del DataSet tras haber pulsado el botn del formulario.
Pgina 26
Pgina 27