Enlazando el GridControl con datos

Enlazando el GridControl con datos.

La principal propiedad para enlazar la columna con datos es: FielName.

Pero para que se vea aun más decente, usaremos también las propiedades Caption y (Name), esta ultima es para tener un mejor control de las columnas, ya que cuendo son muchas es más cómodo controlarlas poniéndoles un nombre, tal como se muestra en la siguiente imagen.

Construyendo las columnas en el GridControl -> Run Designer -> Columns

Para este ejemplo crearemos cuatro columnas y las propiedades mencionadas anteriormente las estableceremos de la siguiente manera.

(name)                 FielName        Caption

colID                      ID                  Id

colNombre            NOMBRE        Nombre

colEdad                EDAD             Edad

colSexo                SEXO              Sexo

Agregar el siguiente código en el load o en el constructor.

Dim TablaClientes As New DataTable("CLIENTES")

'Las columnas deben corresponder con la propiedad FielName, y debemos 

'especificar el tipo de dato para que el GridControl controle los errores de tipos.

With TablaClientes.Columns

    .Add("ID", GetType(Integer))

    .Add("NOMBRE", GetType(String))

    .Add("EDAD", GetType(Integer))

    .Add("SEXO", GetType(String))

End With

With TablaClientes.Rows

    .Add("1", "Raciel Luis", "25", "Hombre")

    .Add("2", "Gabriela Torres", "45", "Mujer")

End With

Me.GridControl1.DataSource = TablaClientes

AddComboBoxEnGridControl() 'El codigo esta más abajo.

Nota: Cabe mencionar que si tenemos una tabla en un DataSet en nuestro diseñador de esquemas, este se puede enlazar de manera automática al control, tal como se muestra en la siguiente imagen.

GridControl en tiempo de ejecución.

Si nos damos cuenta, podemos editar los campos, para no permitir editarlos nos vamos a las propiedades de la columna (AllowEdit la establecemos como False y ReadOnly como True) para que no nos permita editar el registro de la columna deseada, en este ejemplo la columna nombre.

Como mencionaba anteriormente que de debe poner el tipo de dato de las columnas de la tabla que se asociara al control, para aprovechar las validaciones integradas del mismo control. En la siguiente imagen estamos tratando de insertar letras en el campo EDAD, lo cual va a ser incorrecto porque lo definimos como Integer. Ya sea desde codigo o desde el diseñados de esquemas (DataSet's).

Ademas podemos hacer uso de los filtros que agregamos a nuestro control, para asi evitarnos hacer consultas SQL a la base base de datos o en propio DataTable.

Insertando ComboBox en el GridControl

Tomaremos para este ejemplo el campo Sexo.

Agregamos el siguiente procedimiento, el cual lo podemos llamar después del código anterior a este.

   Sub AddComboBoxEnGridControl()        'Repositorio de Items

        Dim RepositorioItemsSexo As New DevExpress.XtraEditors.Repository.RepositoryItemLookUpEdit

        'Agregando el ComboBox en el GridControl

        Dim TablaSexo As New DataTable("SEXO")

        With TablaSexo.Columns

            .Add("IDSEXO")

            .Add("DESCRIPCION")

        End With

       TablaSexo.Columns("IDSEXO").Caption = "Id o clave"
        TablaSexo.Columns("DESCRIPCION").Caption = "Descripción"

        With TablaSexo.Rows

            .Add("M", "Masculino")

            .Add("F", "Femenino")

        End With

        With RepositorioItemsSexo

            .DataSource = TablaSexo

            .ValueMember = "IDSEXO"

            .DisplayMember = "DESCRIPCION"

        End With

        colSexo.ColumnEdit = RepositorioItemsSexo

    End Sub

Nota: para que funcione correctamente tenemos que cambiar los valores de los registros agregados a la tabla.

Quitar:

.Add("1", "Raciel Luis", "25", "Hombre")

.Add("2", "Gabriela Torres", "45", "Mujer")

Reemplazarlo por:

.Add("1", "Raciel Luis", "25", "M")

.Add("2", "Gabriela Torres", "45", "F")

Esto es porque el campo ya lo hemos enlazado a los datos de la tabla sexo.

Nota: Estos datos pueden ser obtenidos mediante una consulta a una base de datos.

Agregar un navegador de datos al GridControl.

Construyendo las columnas en el GridControl -> Run Designer -> Focus, Selection, Navigator -> Embedder Navigator 

y chequeamos la opcion UseEmbeddedNavigator

Ejecutamos la aplicación y veamos todo lo que hemos logrado con nuestro GridControl.

Pero antes de terminar con este control le voy a explicar como visualizar los datos para impresión y ademas exportarlos a distintos formatos de archivos.

Agregamos un boton en el formulario y agregamos la siguiente linea de código:

 Me.GridControl1.ShowPrintPreview()

Cuando hagamos clic veremos el preliminar de los datos.

Desde este reporteador podemos exportar la información a PDF, Excel, Word, etc.