Formatação Avançada de DataGrid com ItemDataBound

Formatação Avançada de DataGrid com ItemDataBound

Estava querendo produzir DataGrids com as mesmas funcionalidades de relatórios impressos e a coisa toda se parecia com alguns sistemas de gerenciamento de informações muito caros que foram substituídos com o .NET. O produto final deveria focar a atenção dos usuários nos dados desejados, sem as complicações de campos extras e outros detalhes. Este artigo se propõe a introduzir o uso de alguns truques simples para incrementar a aparência dos DataGrids.

Veremos então como fazer para:

·        Criar agrupamentos de colunas

·        Realçar subtotais e totais gerais

·        Realçar células individuais com base em valores de dados

Dados SQL e Banco de dados

Foram usados o Northwind e o SQL Server DB para produzir os dados para este artigo, com um subtotal para cada categoria de produto e um total geral no final. O código funcionará para qualquer fonte de dados. As stored procedures SQL foram também incluídas para aqueles que estejam interessados em recriar exatamente o que é mostrado aqui.

Quase toda a lógica de negócio foi colocada no lado do banco de dados, usando o DataGrid apenas para fins de exibição, portanto, toda a ordenação e os totais são feitos aqui.

CREATE PROCEDURE usp_sales_by_cate AS

create table #temp ( Sorty int, CategoryName varchar(50),

         ProductName varchar(50), ProductSales real)

-- Get Base Sales

INSERT INTO #temp

SELECT 0, dbo.Categories.CategoryName, dbo.Products.ProductName,

SUM(dbo.[Order Details Extended].ExtendedPrice)

AS ProductSales

FROM dbo.Categories INNER JOIN

dbo.Products INNER JOIN

dbo.Orders INNER JOIN

dbo.[Order Details Extended] ON dbo.Orders.OrderID =

       dbo.[Order Details Extended].OrderID ON

dbo.Products.ProductID =

 dbo.[Order Details Extended].ProductID ON dbo.Categories.CategoryID =

                  dbo.Products.CategoryID

WHERE (dbo.Orders.OrderDate BETWEEN '19970101' e '19971231')

GROUP BY dbo.Categories.CategoryName, dbo.Products.ProductName

ORDER BY dbo.Categories.CategoryName

-- Build SubTotal

INSERT INTO #temp

SELECT 1 , CategoryName, 'SubTotal', sum( ProductSales)

from #temp

group by CategoryName

-- Build Grand Total

INSERT INTO #temp

SELECT 2 , 'XXXXX', 'Grand Total', sum( ProductSales)

from #temp

Where sorty = 0

-- Display Values

SELECT CategoryName, ProductName, ProductSales from #temp

order by CategoryName, Sorty

Criando Agrupamentos

Não queremos que as categorias sejam exibidas sempre na primeira coluna, porém apenas quando mudarem, o que dará um aspecto limpo e agradável ao DataGrid, permitindo aos usuários achar os itens rápida e facilmente.

Primeiro, criamos uma variável pública que funcionará para a página inteira e, o mais importantemente, lembrará algo a cada vez que o <ITEMDATABOUND> rodar para cada linha do DataGrid. O Page Load, será também pré-configurado (ocorreram algumas situações estranhas em que isto não aconteceu).

public class WebForm1 : System.Web.UI.Page

{

 public string LastColumn;

..

..

private void Page_Load(object sender, System.EventArgs e)

{

// Configurar LastColumn para branco

if (!IsPostBack) LastColumn = "";

A seguir, usamos a variável <LASTCOLUMN> para localizar as alterações nos dados que irão para o DataGrid. Se o valor da célula de cell[0] não for alterado, o texto da mesma será apagado e a borda será removida:

e.Item.Cells[0].Style.Add("BORDER", "none").

Para ignorar o cabeçalho (header) do DataGrid:

if( ( e.Item.ItemType.ToString()!= "Header"))

    {.....

Isto também pode ser utilizado para os itens, itens alternativos e rodapés (footers) em um DataGrid, para especializar o código.

A seguir, o código completo para agrupar a primeira coluna do DataGrid:

private void DataGrid1_ItemDataBound(object sender,

    System.Web.UI.WebControls.DataGridItemEventArgs e)

{

     //Obter o texto da coluna 0 atual

      string CurrentColumn = e.Item.Cells[0].Text;

   // Pular Headers

   if( ( e.Item.ItemType.ToString()!= "Header"))

    {

      // Houve alguma alteração

      if (CurrentColumn == LastColumn)

       {

        // Sem alteração na Coluna 0

        //limpar e remover a borda

        e.Item.Cells[0].Text = "";

        e.Item.Cells[0].Style.Add("BORDER", "none");

       }

      else

        {

         // esta eh a primeira da serie

         // atribuir LastColumn para a coluna atual

         LastColumn = CurrentColumn;

        // Adicionar uma cor de fundo para Cell[0]

        e.Item.Cells[0].BackColor =

               System.Drawing.Color.WhiteSmoke;

        }

}

Realçando Subtotais e Totais Gerais

Isto é bastante simples, caso o texto da célula for "Sub Total" / "Grand Total", então configuramos a fonte, o tipo, as cores, etc.

// Verificar se eh um SubTotal

string MyCol2 = e.Item.Cells[1].Text;

if (MyCol2 == "SubTotal")

 {

  e.Item.Font.Bold = true;

  e.Item.BackColor = Color.DimGray;

  e.Item.ForeColor = Color.White;

  // limpar Column 0

  e.Item.Cells[0].Text = "";

  e.Item.Cells[0].Style.Add("BORDER", "none");

  e.Item.Cells[0].BackColor = Color.Transparent;

 }

if (MyCol2 == "Grand Total")

  {

   e.Item.Font.Bold = true;

   e.Item.BackColor = Color.Red;

   e.Item.ForeColor = Color.White;

   e.Item.Cells[0].Style.Add("BORDER", "none");

   e.Item.Cells[0].BackColor = Color.Transparent;

}

Realçando Células Individuais

Este recurso é amplamente utilizado para exibir valores negativos em vermelho (do modo como se faz em contabilidade). Descobrimos que a conversão de string para número, pode produzir alguns erros estranhos, por isso, geralmente envelopamos as conversões em um try/catch para ignorar qualquer erro que possa surgir.

//  Destacar itens caso as vendas estejam abaixo de 5000

string MyStr = e.Item.Cells[2].Text;

try

{

  double MyValue = double.Parse(MyStr);

  if (MyValue < 5000 )

  {

    e.Item.Cells[2].ForeColor = Color.Red;

    e.Item.Cells[2].Font.Bold = true;

  }

}

catch(Exception)

{

 // numero invalido

}