Arquitetura de controle DataGridView (Windows Forms)

O DataGridView controle e suas classes relacionadas foram projetados para ser um sistema flexível e extensível para exibir e editar dados tabulares. Todas essas classes estão contidas no System.Windows.Forms namespace e são todas nomeadas com o prefixo "DataGridView".

Elementos de arquitetura

As classes complementares primárias DataGridView derivam de DataGridViewElement. O seguinte modelo de objeto ilustra a hierarquia de herança do DataGridViewElement.

A DataGridViewElement classe fornece uma referência ao controle pai DataGridView e tem uma State propriedade, que contém um valor que representa uma combinação de valores da DataGridViewElementStates enumeração.

As seções a seguir descrevem as DataGridView classes complementares com mais detalhes.

DataGridViewElementStates

A DataGridViewElementStates enumeração contém os seguintes valores:

• None

• Frozen

• ReadOnly

• Resizable

• ResizableSet

• Selected

• Visible

Os valores dessa enumeração podem ser combinados com os operadores lógicos bit a bit, de modo que a State propriedade pode expressar mais de um estado ao mesmo tempo. Por exemplo, um DataGridViewElement pode ser simultaneamente Frozen, Selectede Visible.

Células e bandas

O DataGridView controle é composto por dois tipos fundamentais de objetos: células e bandas. Todas as células derivam da DataGridViewCell classe base. Os dois tipos de bandas, DataGridViewColumn e DataGridViewRow, ambos derivam da classe base DataGridViewBand.

O DataGridView controle interopera com várias classes, mas as mais comumente encontradas são DataGridViewCell, DataGridViewColumne DataGridViewRow.

DataGridViewCell

A célula é a unidade fundamental de interação para o DataGridView. A exibição é centralizada em células e a entrada de dados geralmente é executada por meio de células. Você pode acessar células usando a Cells coleção da DataGridViewRow classe e pode acessar as células selecionadas usando a SelectedCells coleção do DataGridView controle. O modelo de objeto a seguir ilustra o uso e mostra a hierarquia de herança de DataGridViewCell.

O DataGridViewCell tipo é uma classe base abstrata, da qual todos os tipos de célula derivam. DataGridViewCell e seus tipos derivados não são controles do Windows Forms, mas hospedam alguns controles do Windows Forms. Qualquer funcionalidade de edição com suporte por uma célula normalmente é tratada por um controle hospedado.

DataGridViewCell os objetos não controlam seus próprios recursos de aparência e pintura da mesma forma que os controles do Windows Forms. Em vez disso, DataGridView é responsável pela aparência de seus DataGridViewCell objetos. Você pode afetar significativamente a aparência e o comportamento das células interagindo com as propriedades e eventos DataGridView do controle. Quando você tem requisitos especiais para personalizações que estão além das capacidades do controle DataGridView, você pode implementar sua própria classe que seja derivada de DataGridViewCell ou de uma de suas subclasses.

A lista a seguir mostra as classes derivadas de DataGridViewCell:

• DataGridViewTextBoxCell

• DataGridViewButtonCell

• DataGridViewLinkCell

• DataGridViewCheckBoxCell

• DataGridViewComboBoxCell

• DataGridViewImageCell

• DataGridViewHeaderCell

• DataGridViewRowHeaderCell

• DataGridViewColumnHeaderCell

• DataGridViewTopLeftHeaderCell

• Seus tipos de célula personalizados

DataGridViewColumn

O esquema do armazenamento de DataGridView dados anexado do controle é expresso nas DataGridView colunas do controle. Você pode acessar as DataGridView colunas do controle usando a Columns coleção. Você pode acessar as colunas selecionadas usando a SelectedColumns coleção. O modelo de objeto a seguir ilustra o uso e mostra a hierarquia de herança de DataGridViewColumn.

Alguns dos principais tipos de célula têm tipos de coluna correspondentes. Elas são derivadas da DataGridViewColumn classe base.

A lista a seguir mostra as classes derivadas de DataGridViewColumn:

• DataGridViewButtonColumn

• DataGridViewCheckBoxColumn

• DataGridViewComboBoxColumn

• DataGridViewImageColumn

• DataGridViewTextBoxColumn

• DataGridViewLinkColumn

• Seus tipos de coluna personalizados

Controles de edição do DataGridView

As células que dão suporte à funcionalidade de edição avançada normalmente usam um controle hospedado derivado de um controle do Windows Forms. Esses controles também implementam a IDataGridViewEditingControl interface. O modelo de objeto a seguir ilustra o uso desses controles.

Os seguintes controles de edição são fornecidos com o DataGridView controle:

• DataGridViewComboBoxEditingControl

• DataGridViewTextBoxEditingControl

Para obter informações sobre como criar seus próprios controles de edição, consulte Como hospedar controles em células DataGridView do Windows Forms.

A tabela a seguir ilustra a relação entre tipos de célula, tipos de coluna e controles de edição.

DataGridViewRow

A DataGridViewRow classe exibe os campos de dados de um registro do armazenamento de dados ao qual o DataGridView controle está anexado. Você pode acessar as DataGridView linhas do controle usando a Rows coleção. Você pode acessar as linhas selecionadas usando a SelectedRows coleção. O modelo de objeto a seguir ilustra o uso e mostra a hierarquia de herança de DataGridViewRow.

Você pode derivar seus próprios tipos da DataGridViewRow classe, embora isso normalmente não seja necessário. O DataGridView controle tem vários eventos relacionados a linhas e propriedades para personalizar o comportamento de seus DataGridViewRow objetos.

Se você habilitar a DataGridView propriedade do AllowUserToAddRows controle, uma linha especial para adicionar novas linhas será exibida como a última linha. Essa linha faz parte da Rows coleção, mas tem uma funcionalidade especial que pode exigir sua atenção. Para obter mais informações, consulte Como usar a linha para novos registros no controle DataGridView dos Windows Forms.

Consulte também

• Visão geral do controle DataGridView
• personalizando o controle DataGridView do Windows Forms
• Usando a linha para novos registros no controle DataGridView dos Windows Forms