Compartir a través de

Cómo: Agregar tablas y columnas al control DataGrid de Windows Forms

  • Artículo

Nota

Aunque el control DataGridView reemplaza y agrega funcionalidad al control DataGrid, este control DataGrid se conserva a efectos de compatibilidad con versiones anteriores y, en su caso, de uso futuro. Para obtener más información, vea Diferencias entre los controles DataGridView y DataGrid de formularios Windows Forms.

Para mostrar datos en el control DataGrid de formularios Windows Forms en formato de tablas y columnas, puede crear objetos DataGridTableStyle y agregarlos al objeto GridTableStylesCollection, al que se obtiene acceso a través de la propiedad TableStyles del control DataGrid. Cada tabla muestra el contenido de la tabla de datos que se haya especificado en la propiedad MappingName del objeto DataGridTableStyle. De forma predeterminada, un estilo de tabla sin estilos de columna especificados mostrará todas las columnas que contenga la tabla de datos. Para restringir las columnas de la tabla que aparecen puede agregar objetos DataGridColumnStyle al objeto GridColumnStylesCollection, al que se tiene acceso mediante la propiedad GridColumnStyles de cada objeto DataGridTableStyle.

Para agregar una tabla y una columna a un control DataGrid mediante programación

  1. Para mostrar los datos de la tabla, deberá enlazar en primer lugar el control DataGrid a un conjunto de datos. Para obtener más información, vea Cómo: Enlazar el control DataGrid de formularios Windows Forms a un origen de datos.

    Nota de precauciónPrecaución

    Cuando especifique estilos de columna mediante programación, cree siempre objetos DataGridColumnStyle y agréguelos al objeto GridColumnStylesCollection antes de agregar objetos DataGridTableStyle al objeto GridTableStylesCollection. Cuando agregue un objeto DataGridTableStyle vacío a la colección, se crearán automáticamente objetos DataGridColumnStyle. En consecuencia, se producirá una excepción si intenta agregar nuevos objetos DataGridColumnStyle con valores MappingName duplicados al objeto GridColumnStylesCollection.

  2. Declare un nuevo estilo de tabla y establezca su nombre de asignación.

    Dim ts1 As New DataGridTableStyle()
ts1.MappingName = "Customers"

    DataGridTableStyle ts1 = new DataGridTableStyle();
ts1.MappingName = "Customers";

    DataGridTableStyle* ts1 = new DataGridTableStyle();
ts1->MappingName = S"Customers";

  3. Declare un nuevo estilo de columna y establezca su nombre de asignación y demás propiedades.

    Dim myDataCol As New DataGridBoolColumn()
myDataCol.HeaderText = "My New Column"
myDataCol.MappingName = "Current"

    DataGridBoolColumn myDataCol = new DataGridBoolColumn();
myDataCol.HeaderText = "My New Column";
myDataCol.MappingName = "Current";

    DataGridBoolColumn^ myDataCol = gcnew DataGridBoolColumn();
myDataCol->HeaderText = "My New Column";
myDataCol->MappingName = "Current";

  4. Llame al método Add del objeto GridColumnStylesCollection para agregar la columna al estilo de tabla.

    ts1.GridColumnStyles.Add(myDataCol)

    ts1.GridColumnStyles.Add(myDataCol);

    ts1->GridColumnStyles->Add(myDataCol);

  5. Llame al método Add del objeto GridTableStylesCollection para agregar el estilo de tabla a la cuadrícula de datos.

    DataGrid1.TableStyles.Add(ts1)

    dataGrid1.TableStyles.Add(ts1);

    dataGrid1->TableStyles->Add(ts1);

Vea también

Tareas

Cómo: Eliminar u ocultar columnas del control DataGrid de formularios Windows Forms

Otros recursos

DataGrid (Control, formularios Windows Forms)