Partilhar via


Como: Gerar colunas automaticamente em um Data-Bound controle DataGridView do Windows Forms

O exemplo de código a seguir demonstra como exibir colunas de uma fonte de dados acoplada em um controle DataGridView. Quando o valor da propriedade AutoGenerateColumns é true (o padrão), uma DataGridViewColumn é criada para cada coluna na tabela da fonte de dados.

Se o controle DataGridView já tiver colunas quando você definir a propriedade DataSource, as colunas acopladas existentes serão comparadas às colunas na fonte de dados e preservadas sempre que houver uma correspondência. As colunas não vinculadas são sempre preservadas. As colunas vinculadas para as quais não há correspondência na fonte de dados são removidas. As colunas na fonte de dados para as quais não há correspondência no controle geram novos objetos DataGridViewColumn, que são adicionados ao final da coleção Columns.

Se quiser excluir determinadas colunas da geração automática, você pode definir a ColumnMapping propriedade do subjacente DataColumn como Hidden. As colunas com essa configuração não serão incluídas no processo de geração automática.

Exemplo

private void BindData()
{
    customersDataGridView.AutoGenerateColumns = true;
    customersDataGridView.DataSource = customersDataSet;
    customersDataGridView.DataMember = "Customers";
}
Private Sub BindData()

    With customersDataGridView
        .AutoGenerateColumns = True
        .DataSource = customersDataSet
        .DataMember = "Customers"
    End With

End Sub

Compilando o código

Este exemplo requer:

Ver também