Como: Adicionar tabelas e colunas para o controle DataGrid do Windows Forms

Observação
O DataGridView controle substitui e adiciona funcionalidade para o DataGrid controle; No entanto, o DataGrid controle é mantido para compatibilidade com versões anteriores e o uso futuro, se você escolher. Para obter mais informações, consulte Diferenças entre o DataGridView do Windows Forms e controles DataGrid.

Você pode exibir dados nos formulários do Windows DataGrid controle em tabelas e colunas criando DataGridTableStyle objetos e adicioná-los para o GridTableStylesCollection objeto, que é acessado através do DataGrid do controle TableStyles propriedade. Cada estilo de tabela exibe o conteúdo de qualquer tabela de dados é especificada na DataGridTableStyle do objeto MappingName propriedade. Por padrão, um estilo de tabela com nenhum estilo de coluna especificado será exibido todas as colunas dessa tabela de dados. Você pode restringir quais colunas da tabela aparecem adicionando DataGridColumnStyle objetos para o GridColumnStylesCollection objeto, que é acessado através do GridColumnStyles propriedade de cada DataGridTableStyle objeto.

Para adicionar uma tabela e coluna para um DataGrid programaticamente

1. Para exibir os dados na tabela, você deve primeiro vincular o DataGrid o controle a um dataset. Para obter mais informações, consulte Como: Vincular o controle DataGrid do Windows Forms a uma fonte de dados.

   Aviso

   Ao especificar programaticamente os estilos de coluna, sempre criar DataGridColumnStyle objetos e adicioná-los para o GridColumnStylesCollection objeto antes de adicionar DataGridTableStyle objetos para o GridTableStylesCollection objeto. Quando você adiciona um vazio DataGridTableStyle o objeto à coleção, DataGridColumnStyle objetos são gerados automaticamente para você. Conseqüentemente, uma exceção será lançada se você tentar adicionar novo DataGridColumnStyle objetos com duplicata MappingName valores para o GridColumnStylesCollection objeto.

2. Declarar um novo estilo de tabela e defina o nome do mapeamento.

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

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

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

3. Declarar um novo estilo de coluna e defina o seu nome de mapeamento e outras propriedades.

   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. Chamar o Add método do GridColumnStylesCollection o objeto para adicionar a coluna para o estilo de tabela

   ts1.GridColumnStyles.Add(myDataCol)
   

   ts1.GridColumnStyles.Add(myDataCol);
   

   ts1->GridColumnStyles->Add(myDataCol);
   

5. Chamar o Add método do GridTableStylesCollection o objeto para adicionar o estilo de tabela à grade de dados.

   DataGrid1.TableStyles.Add(ts1)
   

   dataGrid1.TableStyles.Add(ts1);
   

   dataGrid1->TableStyles->Add(ts1);
   

Consulte também

Tarefas

Como: Excluir ou ocultar colunas no controle Windows Forms DataGrid

Outros recursos

Controle DataGrid (Windows Forms)