Compartir a través de

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

Nota:

El DataGridView control reemplaza y agrega funcionalidad al DataGrid control; sin embargo, el DataGrid control se conserva tanto para la compatibilidad con versiones anteriores como para el uso futuro, si lo desea. Para obtener más información, consulte Diferencias entre los controles DataGridView y DataGrid de Windows Forms.

Puede mostrar datos en el control de Formularios Windows Forms DataGrid en tablas y columnas creando objetos DataGridTableStyle y agregándolos al objeto GridTableStylesCollection , al que se accede a través de la DataGrid propiedad TableStyles del control. Cada estilo de tabla muestra el contenido de la 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 a través de la propiedad GridColumnStyles de cada objeto DataGridTableStyle .

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

  1. Para mostrar los datos de la tabla, primero debe enlazar el DataGrid control 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.

    Precaución

    Cuando se especifican 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 lo tanto, se producirá una excepción si intenta agregar nuevos objetos DataGridColumnStyle con valores MappingNameduplicados 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