O GridView, sem dúvida alguma, representa um grande avanço frente ao DataGrid do ASP.Net 1.1. Porém nossos clientes e usuários sempre necessitam de funcionalidades que vão além das fornecidas nativamente pelo GridView. Um exemplo frequente é a criação de totalizações e agrupamentos. No primeiro caso é relativamente fácil e rápido codificar o evento RowDataBound para obtenção de totais. A criação de grupos no GridView envolve um pouco mais de implementação e depuração. Há dezenas de artigos orientando tais implementações, porém eles induzem os desenvolvedores menos avisados à má prática da recodificação ao invés do reuso.

Mas é apenas quando precisamos combinar os dois recursos, grupos e sumarizações por grupo, que vemos o quanto é fácil se perder em código e depuração, caso não haja uma implementação consistente. Com o objetivo de simplificar essas tarefas desenvolvi o GridViewHelper, que permite a utilização rápida e confiável de tais recursos.

[Ver exemplo online]

[Baixar código fonte]

Uso do GridViewHelper

Veremos abaixo alguns exemplo de uso do GridViewHelper. Primeiramente exibimos o grid de referência, para o qual serão criados os grupos e totalizações. Os dados dos exemplos são do banco Northwind:

Para criar um total para a coluna ItemTotal são necessárias apenas as prometidas 2 linhas de código:

Primeiro criamos a classe GridViewHelper especificando no constructor o grid no qual ela irá atuar. Em seguida registramos o sumário informando o nome da coluna e a operação de sumarização desejada. O resultado pode ser visto abaixo:

No exemplo acima foi adicionada uma nova linha ao grid para o sumário. Uma outra opção é utilizar a própria linha de rodapé (footer) para exibição do sumário ao invés de adicionar uma nova linha. Quando uma nova linha é adicionada ao grid, apenas as células necessárias para exibição dos colunas sumarizadas são criadas. Com a utilização do rodapé todas as células são criadas. No caso de sumários de grupo, a geração de todas as colunas ou apenas das colunas de sumário é um atributo do grupo.

Vamos agora criar um grupo no GridView. O código necessário para o primeiro agrupamento é exibido abaixo:

O primeiro parâmetro do método RegisterGroup informa a coluna para a qual deve ser criado o grupo. É possível também criar um grupo composto por um conjunto de colunas, bastando para isso passar um array com os nomes das colunas que compõem o grupo. O segundo parâmetro informa se o grupo é automático. Nesse caso é criada automaticamente a linha de cabeçalho do grupo. O terceiro parâmetro informa se as colunas que compõem o grupo devem ser ocultadas. O método ApplyGroupSort() define que o grid deve ser ordenado pela(s) coluna(s) do grupo, no caso acima ShipRegion. Isso é requerido para que o agrupamento funcione adequadamente, exceto caso os dados já venham ordenados do banco pela(s) coluna(s) do grupo.

No exemplo abaixo a coluna do grupo (ShipRegion) foi automaticamente ocultada do grid:

Vamos tornar as coisas um pouco mais interessantes, adicionando um sumário para o grupo criado. Precisamos incluir uma linha para registrar um sumário para o grupo criado anteriormente:

Dessa vez há um parâmetro adicional para o método RegisterSummary. Ele especifica o nome do grupo para o qual o sumário deve ser gerado. O nome do grupo é gerado automáticamente a partir dos nomes das colunas que compõem o grupo. Caso o grupo seja composto por apenas uma coluna, o nome do grupo é o nome da própria coluna. Caso seja composto por mais de uma coluna, o nome do grupo é a concatenação ordenada das colunas que compõem o grupo, separadas por um sinal de "+". Ex: "ShipRegion+ShipName".

Abaixo vemos nosso grid com agrupamento e sumário para o grupo:

Podemos incluir um sumário geral (grand total) para o grid acima simplesmente utilizando a sobrecarga adequada do método RegisterSummary, como foi mostrado no primeiro exemplo.

É possível criar mais de um grupo no grid, simulando um agrupamento hierárquico, como vemos abaixo:

Resultado:

Nosso grid após os cosméticos:

Não é exibido nenhum valor para as colunas que não possuem operação de sumarização. Isso é coerente pois o GridViewHelper não sabe como proceder para sumarizar os valores das n linhas do grupo para um único valor. Da mesma forma, em SQL, se especificarmos no SELECT colunas sem função de agregação que não estejam na cláusula group by receberemos uma mensagem parecida com a exibida abaixo:

"Column 'column_name' is invalid in the select list because it is not contained in either an aggregate function or the GROUP BY clause."

É interessante ocultar essas colunas já que elas não fazem sentido por não possuírem função de sumarização nem pertencerem ao grupo de supressão. Para isso precisamos chamar mais um método:

Realmente SetInvisibleColumnsWithoutGroupSummary é um nome muito extenso, mas a intenção foi torná-lo o mais descritivo possível. O resultado pode ser visto abaixo:

Operações de sumarização

O GridViewHelper suporta "nativamente" 3 operações de sumarização: soma, média e contagem de linhas. Uma característica muito interessante é a possibilidade de se especificar operações de sumarização customizadas. Para isso devemos fornecer ao GridViewHelper duas funções: uma que será chamada para cada linha encontrada no grid (ou grupo) e outra para ser consultada e informar o resultado da operação. Abaixo vemos um exemplo de sumarização com operação customizada. A operação semi-dummy criada para esse exemplo retorna o item de menor valor da coluna especificada:

No código acima pode-se ver a assinatura requerida dos métodos. Ambos recebem o nome da coluna e do grupo sendo sumarizados. Caso o sumário não seja relativo a um grupo, o parâmetro group terá valor nulo. O método que é chamado para cada linha encontrada no grid (ou grupo) recebe, além do nome da coluna e do nome do grupo, o valor da coluna na linha corrente.

O resultado é visto abaixo: