Compartilhar via


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

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

Se o DataGridView controle já tiver colunas quando você definir a DataSource propriedade, as colunas associadas existentes serão comparadas com as colunas na fonte de dados e preservadas sempre que houver uma correspondência. Colunas não associadas sempre são preservadas. As colunas associadas 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 DataGridViewColumn objetos, que são adicionados ao final da Columns coleção.

Se você quiser excluir determinadas colunas de serem geradas automaticamente, poderá 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:

Consulte também