Compartir a través de

Procedimiento para agregar tablas y columnas al control DataGrid de Windows Forms

  • Artículo

Nota:

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

Puede mostrar datos en el control DataGrid de Windows Forms en tablas y columnas mediante la creación de objetos DataGridTableStyle y su incorporación al objeto GridTableStylesCollection, al que se accede a través de la propiedad TableStyles del control DataGrid. Cada estilo de tabla muestra el contenido de cualquier tabla de datos especificada en la propiedad MappingName del objeto DataGridTableStyle. De forma predeterminada, un estilo de tabla sin estilos de columna especificados mostrará todas las columnas de esa tabla de datos. Puede restringir qué columnas de la tabla aparecen agregando objetos DataGridColumnStyle al objeto GridColumnStylesCollection, al que se accede mediante la propiedad GridColumnStyles de cada objeto DataGridTableStyle.

Para agregar una tabla y una columna a DataGrid mediante programación, siga estos pasos:

  1. Para mostrar datos en la tabla, primero debe enlazar el control DataGrid a un conjunto de datos. Para obtener más información, vea Procedimiento para enlazar el control DataGrid de Windows Forms a un origen de datos.

    Precaución

    Al especificar estilos de columna mediante programación, cree siempre objetos DataGridColumnStyle y agréguelos al objeto GridColumnStylesCollection antes de agregar objetos DataGridTableStyle al objeto GridTableStylesCollection. Al agregar un objeto DataGridTableStyle vacío a la colección, los objetos DataGridColumnStyle se generan automáticamente. Por tanto, se generará una excepción si trata de 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 otras 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);

Consulte también