|
Neste artigo mostrarei o novo controle do ASP.NET 2.0, chamado GridView. Esta é uma versão muito melhorada do DataGrid das versões 1.x do ASP.NET, contendo uma série de vantagens, principalmente no que diz respeito à agilidade no desenvolvimento, ganhando assim uma enorme produtividade.
As melhorias vão desde as formas de carregarmos o GridView até funcionalidades inexistentes nas versões anteriores, as quais necessitávamos escrever muito código para atender algo mais específico. Grandes melhorias foram criadas, como por exemplo: novos tipos de colunas, ordenação e paginação de registros sem a escrita de nenhuma linha de código, entre outras.
Veremos no decorrer deste artigo essas novas funcionalidades, que estão cada uma delas, separadas por assunto, relacionadas abaixo:
Conteúdo
Objetos de DataSource
A nova versão do .NET Framework disponibiliza diversos tipos de controles para facilitar o acesso aos dados e fazer a ponte até o controle que será exibido no cliente. Veremos neste tópico dois grandes controles: SqlDataSource, ObjectDataSource e o XmlDataSource, que irão nos proporcionar uma grande facilidade, independentemente de onde estamos resgatamos os dados, seja diretamente de um banco de dados ou mesmo de alguma função de uma classe qualquer.
Habilitando a Paginação de Registros
A paginação é uma característica interessante quando trabalhamos com um grande volume de dados em uma página ASP.NET, e uma técnica que se não for bem utilizada pode causar uma baixa performance na aplicação. Veremos neste tópico as formas de como trabalhar com esta funcionalidade utilizando o GridView.
Formatando o GridView
Analisaremos neste tópico como formatar o GridView utilizando os temas que já estão embutidos, por padrão, no ASP.NET. Além disso, o tópico abordará como customizar uma determinada linha de acordo com um valor da fonte de dados e formatar os valores de cada coluna.
Exibindo Imagens
Há ocasiões que queremos exibir no controle GridView imagens que estão na base de dados. Na versão anterior do ASP.NET tínhamos que criar um TemplateColumn para essa finalidade. Já no GriView, isso não é preciso, pois existe um tipo de coluna específica para isso, chamada de ImageField.
Exibindo Detalhes de um Registro
Quando temos uma listagem de registros em um controle GridView, muitas vezes nem todos os campos são exibidos nele por questões de layout. O ASP.NET 2.0 fornece um controle chamado DetailsView, que veremos neste tópico a forma de trabalhar este controle em conjunto com o GridView.
Editando Registros
Além de exibir dados, o controle GridView (assim como é possível utilizando o DataGrid do ASP.NET 1.x) permite a edição de registros "in-place", ou seja, podemos editar os registros no mesmo local em que os mesmos estão sendo exibidos no GridView. Esta seção abordará esta funcionalidade.
Utilizando Template Columns
Apesar de todas essas funcionalidades que descrevemos detalhadamente acima, há ocasiões que estas não satisfazem uma determinada necessidade. É neste momento que a coluna do tipo Template tem a sua utilidade, pois podemos customizá-la de acordo com a necessidade da aplicação. Veremos neste tópico a forma de como trabalhar com elas.
Download do Código Fonte
Como os projetos estão na mesma solução, você pode definir qual deles vai quer iniciar quando você pressionar Ctrl + F5. Independente de qual dos projetos você escolha, uma página Default.aspx será visualizada no browser com o índice do artigo (Visual Basic .NET | Visual C#). Vale lembrar também que talvez precise ajustar o path do arquivo *.mdf (base de dados), pois isso depende do local onde você executa o projeto.
É muito comum trabalharmos com acesso a dados em qualquer tipo de aplicação, seja Windows, Web, Web Service, etc., e com isso, escrevemos diversos tipos de códigos para diversas operações, como por exemplo:
- paginação
- habilitar a ordenação
- exibição de registro detalhado
- edição
- exclusão
Para que conseguíssemos desenvolver estas funcionalidades na versão anterior do ASP.NET 1.x, tínhamos que escrever bastante linhas de códigos. Nada muito exagerado, porém de certa forma por muitas vezes o código era redundante.
Como estas tarefas são bastante utilizadas em nosso dia-a-dia, a Microsoft criou controles do tipo Data Bound para não precisarmos ir diretamente ao código para criar tais funcionalidades. Esses controles são: SqlDataSource, ObjectDataSource e o XmlDataSource.
Esses controles são totalmente compatíveis com o controle que é tema deste artigo, o GridView, permitindo com esta integração, uma grande facilidade em criar aplicações que acessam e manipulam os dados de forma bem fácil e intuitiva (através das Smart Tags), permitindo assim atingir também desenvolvedores iniciantes que ainda não estão à vontade trabalhando diretamente com código.
Os controls Data Bound encapsulam a maioria das operações, que antes precisavam ser desenvolvidas para diferentes repositórios de dados. Isso tira a preocupação de definir e/ou gerir a conexão com a base de dados, a query e seus respectivos parâmetros que serão utilizados. Através de propriedades podemos especificar seus devidos valores em design-time.
Abaixo vemos a finalidade de cada um desses controles:
SqlDataSource: Fornece acesso à uma base de dados SQL Server.
ObjectDataSource: Fornece acesso à um determinado método de uma alguma classe. Estas classes geralmente encapsulam o acesso à base de dados, ou qualquer repositório, retornando uma coleção de objetos que deve ser apresentada ao usuário.
XmlDataSource: Fornece acesso e manipulação à um arquivo XML.
Abaixo abordaremos cada um desses controles detalhadamente.
SqlDataSource
Como já vimos, este controle é responsável por encapsular a manipulação dos dados de uma base de dados SQL Server. Temos nele propriedades essencias, como por exemplo, os comandos SelectCommand, InsertCommand, DeleteCommand e UpdateCommand, que é onde definimos os comandos (queries ou Stored Procedures) que serão executadas para cada ação.
Podemos definir estas propriedades via design (IDE), através da janelas de propriedades do Visual Studio .NET 2005 ou declarativamente no código HTML da página ASPX. Utilizando a IDE do Visual Studio .NET 2005 existem as chamadas Smart Tags, que são uma espécie de "Wizard", onde podemos configurar passo a passo cada uma dessas propriedades, habilitando inclusive uma opção para manipular as colunas que queremos exibir ao usuário.
Depois de arrastar um SqlDataSource para o nosso WebForm, haverá um botão no canto superior direito deste que, ao clicar, um wizard é exibido para fazermos as configurações. Abaixo a Figura 1 ilustra este processo:
 |
| Figura 1 - Utilizando as Smart Tags para configuração. |
Ao clicar em Configure Data Source..., uma nova janela será aberta informando as configurações à serem efetuadas para o funcionamento do objeto SqlDataSource. Isso inclui desde a escolha do banco de dados, passando pela query (ou Stored Procedure) que será executada. Há uma opção chamada Advanced que, geramos automaticamente os comandos de Insert, Delete e Update (semelhante ao que já fazemos atualmente com o Dataset e DataAdapter). As imagens abaixo ilustram este processo passo à passo:
 |
| Figura 2 - Definindo o banco de dados a ser utilizado. |
 |
| Figura 3 - Gerando as queries ou Stored Procedures para as operações de CRUD. |
 |
Figura 4 - Esta opção é habilitada quando clicamos no botão Advanced... da figura anterior, onde definimos se os comandos de CRUD serão ou não gerados automaticamente. |
É importante informar que os comandos gerados automaticamente são baseados no comando de seleção. Logo, os campos que são informados na seleção refletem nos comandos de inserção e atualização. Veremos abaixo o código HTML correspondente ao nosso objeto SqlDataSource e o controle GridView, gerado em nosso arquivo ASPX:
<asp:SqlDataSource
ID="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:ConnString %>"
SelectCommand="SELECT [UsuarioID], [Nome], [Email] FROM [Usuario]"
DeleteCommand="DELETE FROM [Usuario] WHERE [UsuarioID] = @original_UsuarioID"
InsertCommand="INSERT INTO [Usuario] ([Nome], [Email]) VALUES (@Nome, @Email)"
UpdateCommand="UPDATE [Usuario] SET [Nome] = @Nome, [Email] = @Email
WHERE [UsuarioID] = @original_UsuarioID">
<DeleteParameters>
<asp:Parameter Name="original_UsuarioID" Type="Int32" />
</DeleteParameters>
<UpdateParameters>
<asp:Parameter Name="Nome" Type="String" />
<asp:Parameter Name="Email" Type="String" />
<asp:Parameter Name="original_UsuarioID" Type="Int32" />
</UpdateParameters>
<InsertParameters>
<asp:Parameter Name="Nome" Type="String" />
<asp:Parameter Name="Email" Type="String" />
</InsertParameters>
</asp:SqlDataSource>
<asp:GridView
ID="GridView1"
runat="server"
DataSourceID="SqlDataSource1">
</asp:GridView>
|
|
ASPX
|
|
Como podemos ver no código HTML correspondente ao objeto SqlDataSource, os comandos são gerados com códigos T-SQL e estão devidamente em suas respectivas propriedades. Para cada comando, há uma seção no código HTML do objeto SqlDataSource que são definidos os parâmetros que serão utilizados pela query (ou Stored Procedure), incluindo o seu nome e tipo de dado.
Depois de completamente configurado o objeto SqlDataSource, o definimos como a fonte de dados para o controle GridView, através da propriedade DataSourceID como vimos no código HTML acima. A imagem abaixo ilustra como definir o DataSource do GridView através da Smart Tag:
 |
| Figura 5 - Selecionando o Data Source do controle GridView. |
ObjectDataSource
Este objeto destina-se também a vincular os dados ao controle GridView, mas utilizando uma função de uma classe qualquer que nos retorne uma coleção de objetos. Porém sem a necessidade de fazer diretamente via código. O processo de vinculação é também parecido com o objeto SqlDataSource em relação à forma de vínculo ao GridView; o que difere logicamente é o "Wizard" que é exibido para a configuração do mesmo.
Antes de exibir o wizard vamos montar o código que será responsável por resgatar os dados da base de dados, popular os objetos e, consequentemente, retornar uma coleção do mesmo. Abaixo é exibido a classe "Usuario":
using System;
public class Usuario
{
private int _id;
private string _nome;
private string _email;
private string _endereco;
private string _cidade;
private string _estado;
private string _foto;
public int ID
{
get { return this._id; }
set { this._id = value; }
}
public string Nome
{
get { return this._nome; }
set { this._nome = value; }
}
public string Email
{
get { return this._email; }
set { this._email = value; }
}
public string Endereco
{
get { return this._endereco; }
set { this._endereco = value; }
}
public string Cidade
{
get { return this._cidade; }
set { this._cidade = value; }
}
public string Estado
{
get { return this._estado; }
set { this._estado = value; }
}
public string Foto
{
get { return this._foto; }
set { this._foto = value; }
}
}
Imports Microsoft.VisualBasic
Public Class Usuario
Private _id As Integer
Private _nome As String
Private _email As String
Private _endereco As String
Private _cidade As String
Private _estado As String
Private _foto As String
Public Property ID() As Integer
Get
Return Me._id
End Get
Set(ByVal value As Integer)
Me._id = value
End Set
End Property
Public Property Nome() As String
Get
Return Me._nome
End Get
Set(ByVal value As String)
Me._nome = value
End Set
End Property
Public Property Email() As String
Get
Return Me._email
End Get
Set(ByVal value As String)
Me._email = value
End Set
End Property
Public Property Endereco() As String
Get
Return Me._endereco
End Get
Set(ByVal value As String)
Me._endereco = value
End Set
End Property
Public Property Cidade() As String
Get
Return Me._cidade
End Get
Set(ByVal value As String)
Me._cidade = value
End Set
End Property
Public Property Estado() As String
Get
Return Me._estado
End Get
Set(ByVal value As String)
Me._estado = value
End Set
End Property
Public Property Foto() As String
Get
Return Me._foto
End Get
Set(ByVal value As String)
Me._foto = value
End Set
End Property
End Class
|
|
C#
|
VB.NET
|
|
Depois da classe que armazena os valores provenientes do banco de dados ou de qualquer outra repositório, vamos criar a classe que tem a finalidade de ir até o banco de dados, resgatar os dados através de objetos que já são de nosso conhecimento (SqlConnection, SqlCommand, SqlDataReader) e popular objetos do tipo Usuario, que criamos logo acima. O código abaixo é responsável por esse processo:
using System;
using System.Data;
using System.Data.SqlClient;
using System.Configuration;
using System.Web.Configuration;
using System.Collections.Generic;
public class Usuarios
{
public List<Usuario> ResgataUsuarios() {
List<Usuario> coll = new List<Usuario>();
string connString =
WebConfigurationManager.ConnectionStrings["ConnString"].ConnectionString
SqlConnection conn = new SqlConnection(connString);
SqlCommand cmd =
new SqlCommand("SELECT UsuarioID, Nome, Email FROM Usuario", conn);
SqlDataReader dr = null;
try
{
conn.Open();
dr = cmd.ExecuteReader(CommandBehavior.CloseConnection);
while(dr.Read()){
Usuario u = new Usuario();
u.ID = dr.GetInt32(0);
u.Nome = dr.GetString(1);
u.Email = dr.GetString(2);
coll.Add(u);
}
}
finally {
if (dr != null)
dr.Close();
}
return coll;
}
}
Imports Microsoft.VisualBasic
Imports System.Data.SqlClient
Imports System.Web.Configuration
Public Class Usuarios
Public Function ResgataUsuarios() As Generic.List(Of Usuario)
Dim coll As New Generic.List(Of Usuario)
Dim connString As String =
WebConfigurationManager.ConnectionStrings("ConnString").ConnectionString
Dim conn As New SqlConnection(connString)
Dim cmd As New SqlCommand("SELECT UsuarioID, Nome, Email FROM Usuario", conn)
Dim dr As SqlDataReader = Nothing
Try
conn.Open()
dr = cmd.ExecuteReader(Data.CommandBehavior.CloseConnection)
While dr.Read()
Dim u As New Usuario
With u
.ID = dr.GetInt32(0)
.Nome = dr.GetString(1)
.Email = dr.GetString(2)
End With
coll.Add(u)
End While
Finally
If Not IsNothing(dr) Then
dr.Close()
End If
End Try
Return coll
End Function
End Class
|
|
C#
|
VB.NET
|
|
Como vemos, a classe Usuarios possui um método público que retorna uma lista tipificada de objetos do tipo Usuario. É este método que vamos definir no objeto ObjectDataSource, que fará todo o trabalho, desde criar a instância da classe até a chamada do método e a carga do controle GridView.
Veremos abaixo o passo à passo de como configurar o objeto ObjectDataSource com esta classe e método. Ao clicar na Smart Tag e escolhendo a Configure Data Source..., temos:
 |
| Figura 6 - Selecionando o Objeto da classe de negócios. |
 |
| Figura 7 - Selecionando os métodos. |
Como podemos ver na Figura 7, temos as abas para definir os métodos para Select, Update, Insert e Delete. Podemos ver que é mesmo muito semelhante a forma que trabalhamos com o objeto SqlDataSource mas, neste caso, devemos informar as funções que estão na classe de negócios responsáveis por cada ação. O código HTML resultante da criação deste objeto ObjectDataSource no arquivo ASPX é:
<asp:ObjectDataSource
ID="ObjectDataSource1"
runat="server"
SelectMethod="ResgataUsuarios"
TypeName="Usuarios">
</asp:ObjectDataSource>
<asp:GridView
ID="GridView1"
runat="server"
DataSourceID="ObjectDataSource1">
</asp:GridView>
|
|
ASPX
|
|
Uma propriedade que ainda não analisamos é a TypeName, que recebe uma String que corresponde ao nome da classe que o objeto ObjectDataSource representará, utilizando Reflection para carregar e executar o(s) método(s) deste tipo. Esta String contém o nome de um determinado tipo particalmente qualificado, que está localizado nos diretórios \Bin ou \App_Code. Se o componente estiver registrado no Global Assembly Cache - GAC a String conterá o tipo complemento, incluindo o Namespace. Vale lembrar que, se o componente estiver no Global Assembly Cache, você deverá fazer as devidas referências no Machine.Config ou Web.Config, dependendo da sua necessidade.
Nota Importante: Se por algum motivo a classe de regras de negócios tiver um construtor parametrizado, você deverá utilizar o evento ObjectCreating do objeto ObjectDataSource. Este evento é invocado antes da criação do objeto, permitindo customizar esta instanciação. Um dos parâmetros do evento, é um objeto do tipo ObjectDataSourceEventArgs, que possui uma propriedade (escrita/leitura) chamada ObjectInstance, que tem a responsabilidade de executar os métodos que foram definidos nas propriedades [XXX]Method. Quando esta propriedade é definida neste evento, o objeto ObjectDataSource irá respeitar, executando os métodos baseando-se nesta instância. O código abaixo exibe a forma de como customizar:
protected void ObjectDataSource1_ObjectCreating(object sender,
ObjectDataSourceEventArgs e){
string conn =
WebConfigurationManager.ConnectionStrings["ConnString"].ConnectionString;
Usuarios usuarios =
new Usuarios(conn);
e.ObjectInstance = usuarios;
}
Protected Sub ObjectDataSource1_ObjectCreating(ByVal sender As Object, _
ByVal e As System.Web.UI.WebControls.ObjectDataSourceEventArgs) _
Handles ObjectDataSource1.ObjectCreating
Dim conn As String = _
WebConfigurationManager.ConnectionStrings.Item("ConnString").ConnectionString
Dim usuarios As New Usuarios(conn)
e.ObjectInstance = usuarios
End Sub
|
|
C#
|
VB.NET
|
|
XmlDataSource
Além dos objetos que vimos anteriormente, o ASP.NET 2.0 ainda disponibiliza um objeto nas mesmas características, mas este é utilizado para acessar arquivos XML. Este objeto é chamado de XmlDataSouce. Criei abaixo um arquivo XML chamado de Usuarios.xml, que contém uma relação de usuários para demonstrar a configuração e utilização deste objeto.
<?xml version="1.0" encoding="utf-8" ?>
<Usuarios>
<Usuario
Nome="Israel Aece"
Email="israel@projetando.net"
Cidade="Valinhos">
</Usuario>
<Usuario
Nome="Claudia Fernanda"
Email="claudia@projetando.net"
Cidade="Valinhos">
</Usuario>
<Usuario
Nome="Juliano Aece"
Email="juliano@projetando.net"
Cidade="Valinhos">
</Usuario>
<Usuario
Nome="Carlos Bonna"
Email="bonna@projetando.net"
Cidade="Campinas">
</Usuario>
</Usuarios>
|
|
XML
|
|
Depois do arquivo XML criado, vamos definí-lo como a fonte de dados de controle GridView utilizando o objeto XmlDataSource. A figura abaixo exibe como configurá-lo:
 |
| Figura 8 - Configurando o objeto XmlDataSource. |
No campo Data File (campo obrigatório) definimos o caminho do arquivo que queremos que o objeto XmlDataSource carregue. Já no campo Tranform File você pode definir opcionalmente um arquivo com os estilos (*.xsl) para que, se necessário, você altere a estrutura do arquivo XML. O código HTML gerado por este objeto é apresentado abaixo:
<asp:XmlDataSource
ID="XmlDataSource1"
runat="server"
DataFile="~/Usuarios.xml">
</asp:XmlDataSource>
<asp:GridView
ID="GridView1"
runat="server"
DataSourceID="XmlDataSource1">
</asp:GridView>
|
|
ASPX
|
|
Tipos de Parâmetros
Quando utilizamos algum objeto de DataSource, temos ainda uma seção dentro deles que não exploramos. Esta seção é definida através dos elementos FilterParameters, SelectParameters, InsertParameters, DeleteParameters e UpdateParameters. É através deles que passamos para a query, Stored Procedure ou método quando for uma classe de negócios os valores para os parâmetros que são necessários para efetuar a operação corretamente.
Dentro desta seção podemos definir os parâmetros que serão utilizados, porém customizando-os de acordo com a sua origem, ou seja, podemos ter parâmetros provenientes de QueryStrings, variáveis de sessão, Cookies, controles do formulário, entre outros.
Para cada um destes tipos de parâmetros existe uma classe específica que é herdada diretamente da classe Parameter que está contida no namespace System.Web.UI.WebControls. A classe Parameter fornece um mecanismo para preencher os parâmetros necessários na query, Stored Procedure ou classe de negócios. É esta a classe base para todos os tipos de parâmetros do ASP.NET.
Vejamos abaixo os tipos de parâmetros suportados pelo ASP.NET, que são classes derivadas da classe Parameter:
|
Classe
|
Descrição
|
ControlParameter
|
Este tipo de parâmetro é responsável por resgatar um determinado controle do WebForm através da propriedade ID que deve ser passada para este parâmetro através da propriedade ControlID. Outra propriedade essencial à este tipo de parâmetro é a PropertyName, na qual você deverá informar qual é a propriedade do controle que o ASP.NET deverá recuperar o valor. Abaixo é listado os controles e suas respectivas propriedades que são utilizadas neste cenário:
- Label.Text
- TextBox.Text
- ListControl.SelectedValue
- CheckBox.Checked
- Calendar.SelectedDate
- DetailsView.SelectedValue
- GridView.SelectedValue
- TreeView.SelectedValue
- FileUpload.FileBytes
|
CookieParameter
|
Neste caso é passado ao parâmetro o valor contido dentro de um objeto do tipo HttpCookie. Deve-se informar através da propriedade CookieName o nome do Cookie à ser recuperado.
|
FormParameter
|
Define o valor do parâmetro com o valor que está contido dentro de um controle HTML. Deve-se informar através da propriedade FormField o nome do controle HTML à ser recuperado.
|
ProfileParameter
|
Define o valor do parâmetro com o valor que está contido dentro de uma propriedade do objeto Profile. Deve-se informar através da propriedade ParameterName o nome da propriedade do objeto Profile à ser recuperado.
|
QueryStringParameter
|
Define o valor do parâmetro com o valor que está contido dentro de uma QueryString. Deve-se informar através da propriedade QueryStringField o nome da QueryString à ser recuperado.
|
SessionParameter
|
Define o valor do parâmetro com o valor que está contido dentro de uma variável de sessão. Deve-se informar através da propriedade SessionField o nome da variável de sessão à ser recuperado.
|
|
Como todos esses parâmetros herdam da classe Parameter, os mesmos contém uma propriedade chamada DefaultValue que utilizamos para definir um valor padrão para quando o valor, controle ou propriedade dos respectivos parâmetros não estiverem disponíveis ou forem inválidos.
Abaixo veremos a utilização de dois desses parâmetros: o ControlParameter e o QueryStringParameter. O cenário do exemplo é resgatar os usuários baseando-se em um Estado (UF) informado pelo usuário, através de um TextBox (Figura 9) e QueryString (Figura 10):
<asp:SqlDataSource
ID="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:ConnString %>"
SelectCommand="SELECT [Nome], [Email] FROM [Usuario] WHERE Estado = @UF">
<SelectParameters>
<asp:ControlParameter
ControlID="txtUF"
PropertyName="Text"
Name="UF" />
</SelectParameters>
</asp:SqlDataSource>
|
|
ASPX
|
|
 |
| Figura 9 - Utilizando o parâmetro do tipo ControlParameter. |
<asp:SqlDataSource
ID="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:ConnString %>"
SelectCommand="SELECT [Nome], [Email] FROM [Usuario] WHERE Estado = @UF">
<SelectParameters>
<asp:QueryStringParameter
QueryStringField="UF"
Name="UF" />
</SelectParameters>
</asp:SqlDataSource>
|
|
ASPX
|
|
 |
| Figura 10 - Utilizando o parâmetro do tipo QueryStringParameter. |
Como podemos certificar, o valor do parâmetro (independente de onde está vindo) é passado, neste caso, para a query definida na propriedade SelectCommand utilizando o objeto SqlDataSource.
Eventos
Como estes objetos derivam de uma classe em comum (DataSourceControl) o mesmos tem alguns eventos semelhantes. Veremos cada sum desses eventos e suas respectivas descrições listadas na tabela abaixo:
|
Evento
|
Descrição
|
Deleted
|
Ocorre quando a exclusão é completada.
|
Deleting
|
Ocorre antes de executar a operação de exclusão.
|
Filtering
|
Ocorre antes de executar a operação de filtro.
|
Inserted
|
Ocorre quando a inserção é completada.
|
Inserting
|
Ocorre antes de executar a operação de inserção.
|
Selected
|
Ocorre quando a seleção é completada.
|
Selecting
|
Ocorre antes de executar a operação de seleção.
|
Updated
|
Ocorre quando a atualização é completada.
|
Updating
|
Ocorre antes de executar a operação de atualização.
|
ObjectCreated*
|
Ocorre depois que o objeto especificado na propriedade PropertyName for criado.
|
ObjectCreating*
|
Ocorre antes que o objeto especificado na propriedade PropertyName seja criado.
|
ObjectDisposing*
|
Ocorre antes que o objeto especificado na propriedade PropertyName seja destruído.
|
|
* Eventos pertencentes apenas ao objeto ObjectDataSource.
Ao contrário das versões anteriores, o controle GridView nos fornece uma grande quantidade de tipos de colunas, que antes só conseguíamos através da criação manual de uma Template Column. Para que o desenvolvedor perca não tempo na criação destes tipos de colunas a Microsoft já implementou no GridView alguns novos tipos de colunas que usamos com bastante frequencia nas aplicações atuais. As mesmas estão listadas abaixo:
- BoundField
- CheckBoxField
- HyperLinkField
- ImageField
- ButtonField
- CommandField
- TemplateField
Voltando ao DataGrid da versão 1.x do ASP.NET, tínhamos que ir até o Property Builder para definirmos as colunas que queríamos que fossem apresentadas neste controle. Atualmente temos o que chamamos de Smart Tags que nos auxiliam, disponibilizando um acesso rápido e intuitivo às principais propriedades dos controles. É através destas Smart Tags que abrimos a janela para criarmos e editarmos as colunas que queremos em nosso controle GridView. A figura abaixo ilustra isso:
 |
| Figura 1 - Definindo as colunas do GridView. |
Ao clicar em Edit Columns... na Smart Tag uma nova janela é aberta, e então definiremos as colunas do nosso GridView. Na figura abaixo conseguimos visualizar, envolvidas em um quadrado vermelho, os tipos das colunas mencionadas acima:
 |
| Figura 2 - Visualizando e definindo as colunas do GridView. |
Dentro desta janela principal temos três importantes seções que configurarão as colunas do GridView. A figura abaixo exibe essas seções e veremos qual a finalidade de cada uma delas:
 |
| Figura 3 - Seções da Janela de colunas. |
1 - Exibe as colunas disponíveis para adicionarmos no GridView.
2 - Exibe as colunas que já fazem parte do GridView.
3 - As propriedades correspondentes a cada coluna selecionada na seção 2.
Quando já temos um controle do tipo Data Source definido, como é ilustrado na figura 3, já são listados como BoundFields os campos provenientes desta fonte, nos quais podemos também definir como uma coluna do GridView.
Para adicionarmos uma nova coluna ao GridView basta selecionar o tipo da mesma na seção 1 e clicar no botão Add. Assim a mesma aparecerá na seção 2, onde podemos ajustar e definir as propriedades na seção 3 desta janela. Também nesta seção (a número 2), temos a opção de exclusão de uma coluna, clicando no botão X. Finalmente, ainda nesta seção, temos mais dois botões onde definimos a ordem de cada coluna.
Outra opção que chama a atenção é a propriedade Auto-generate fields, que é responsável por gerar automaticamente as colunas do GridView refletindo exatamente os campos do controle Data Source informado. Há também um link chamado Convert this field into a TemplateField, que tem a finalidade de converter qualquer coluna definida no controle GridView em uma Template, que permite ao desenvolvedor manipular manualmente.
Tipos de Colunas
BoundField
Esta coluna simplesmente representa um campo da fonte de dados em uma coluna como um texto (Label) dentro do GridView. É esta a coluna padrão para todos os campos do tipo texto da fonte de dados, em caso de não defirnirmos manualmente.
O código HTML gerado na página ASPX por este tipo de coluna é exibido abaixo:
<asp:GridView
ID="GridView1"
runat="server"
DataSourceID="SqlDataSource1"
AutoGenerateColumns="False"
DataKeyNames="UsuarioID">
<Columns>
<asp:BoundField
DataField="UsuarioID"
HeaderText="UsuarioID"
InsertVisible="False"
ReadOnly="True"
SortExpression="UsuarioID" />
<asp:BoundField
DataField="Nome"
HeaderText="Nome"
SortExpression="Nome" />
<asp:BoundField
DataField="Email"
HeaderText="Email"
SortExpression="Email" />
</Columns>
</asp:GridView>
|
|
ASPX
|
|
Abaixo é mostrado uma listagem com as principais propriedades da coluna BoundField:
|
Propriedade
|
Descrição
|
DataField
|
Define a coluna da fonte de dados que será exibida.
|
NullDisplayText
|
Define um valor padrão para ser exibido quando o campo da fonte de dados for nulo.
|
|
CheckBoxField
Esta coluna é um caso típico onde nas versões 1.x do ASP.NET precisávamos criar uma coluna do tipo TemplateColumn se quiséssemos exibir um valor booleano em formato de um controle CheckBox. Isso foi resolvido com a criação da coluna CheckBoxField, que representa através de um controle CheckBox um valor booleano da fonte de dados.
O código HTML gerado na página ASPX por este tipo de coluna é exibido abaixo:
<asp:GridView
ID="GridView1"
runat="server"
DataSourceID="SqlDataSource1"
AutoGenerateColumns="False"
DataKeyNames="UsuarioID">
<Columns>
<asp:CheckBoxField
DataField="Ativo"
HeaderText="Ativo"
SortExpression="Ativo" />
</Columns>
</asp:GridView>
|
|
ASPX
|
|
Abaixo é mostrado uma listagem com as principais propriedades da coluna CheckBoxField:
|
Propriedade
|
Descrição
|
DataField
|
Define a coluna booleana da fonte de dados que será exibida no controle CheckBox.
|
Text
|
Define um valor padrão a ser exibido como "Label" ao controle CheckBox.
|
|
HyperLinkField
Apesar desta coluna já existir na versão 1.x do ASP.NET, ela tem uma limitação: só podemos definir um único parâmetro através do Property Builder do controle DataGrid. Se por alguma situação especial precisássemos ter mais de um parâmetro definido na QueryString, tínhamos que recorrer ao código para fazer isso. Essa deficiência foi sanada nesta nova versão, onde agora podemos definir não apenas um campo da fonte de dados, mas sim um Array contendo os nomes dos campos que desejamos anexar à URL.
O código HTML gerado na página ASPX por este tipo de coluna é exibido abaixo:
<asp:GridView
ID="GridView1"
runat="server"
DataSourceID="SqlDataSource1"
AutoGenerateColumns="False"
DataKeyNames="UsuarioID">
<Columns>
<asp:HyperLinkField
DataNavigateUrlFields="UsuarioID,Ativo"
DataNavigateUrlFormatString="?ID={0}&Ativo={1}"
DataTextField="Nome"
NavigateUrl="Pagina.aspx" />
</Columns>
</asp:GridView>
|
|
ASPX
|
|
Abaixo é mostrado uma listagem com as principais propriedades da coluna HyperLinkField:
|
Propriedade
|
Descrição
|
DataNavigateUrlFields
|
Contém os nomes das colunas que serão anexadas à URL, separadas por vírgula.
|
DataNavigateUrlFormatString
|
Define a String que especifica os parâmetros e suas posições na QueryString.
|
DataTextField
|
Define a coluna da fonte de dados que será exibida na propriedade Text do HyperLink.
|
NavigateUrl
|
Define a página de destino a qual o usuário será redirecionado ao clicar.
|
Text
|
Define um valor que será exibido na propriedade Text do HyperLink.
|
|
ImageField
Como já vimos um pouco acima, este tipo de coluna também exigia a criação de uma coluna do tipo TemplateColumn nas versões anteriores do ASP.NET. A coluna ImageField veio para suprir esta necessidade, possibilitando exibir uma imagem proveniente de uma fonte de dados (seja o caminho/path ou a imagem em si).
Caso você tenha na sua fonte de dados a imagem em si ao invés de um path/caminho para um arquivo físico, você terá que criar um Handler (implementando a Interface IHttpHandler) para exibir a referida Imagem. Como isso foge do escopo deste artigo, fica registrado aqui um artigo do Dino Esposito, onde ele explica como criar e implementar este Handler.
O código HTML gerado na página ASPX por este tipo de coluna é exibido abaixo:
<asp:GridView
ID="GridView1"
runat="server"
DataSourceID="SqlDataSource1"
AutoGenerateColumns="False"
DataKeyNames="UsuarioID">
<Columns>
<asp:ImageField
DataImageUrlField="Foto"
DataImageUrlFormatString="~/Images/{0}">
</asp:ImageField>
</Columns>
</asp:GridView>
|
|
ASPX
|
|
Abaixo é mostrado uma listagem com as principais propriedades da coluna ImageField:
|
Propriedade
|
Descrição
|
DataImageUrlField
|
Define a coluna da fonte de dados que contém o Path da foto a ser exibida.
|
DataImageUrlFormatString
|
Contém a formatação da URL para a imagem a ser exibida.
|
|
ButtonField
Este tipo de coluna representa uma coluna da fonte de dados em formato de um Button. É utilizada quando queremos executar uma ação customizada em nosso GridView ou fora dele, no qual podemos identificá-la através da propriedade CommandName que definimos para esta coluna.
O código HTML gerado na página ASPX por este tipo de coluna é exibido abaixo:
<asp:GridView
ID="GridView1"
runat="server"
DataSourceID="SqlDataSource1"
AutoGenerateColumns="False"
DataKeyNames="UsuarioID">
<Columns>
<asp:ButtonField
DataTextField="Nome"
Text="Button"
CommandName="Exibir" />
</Columns>
</asp:GridView>
|
|
ASPX
|
|
Abaixo é mostrado uma listagem com as principais propriedades da coluna ButtonField:
|
Propriedade
|
Descrição
|
CommandName
|
Define uma String como uma espécie de "chave" para sabermos que botão foi clicado e, assim, executar uma determinada ação.
|
DataTextField
|
Define o nome da coluna da fonte de dados que será apresentado na propriedade Text do Button.
|
|
CommandField
Representa um conjunto especial de controles que, acrescentado ao GridView, habilita-o para operações de Select, Cancel, Update, Insert e Delete para manipular os dados que foram carregados através da fonte de dados.
O código HTML gerado na página ASPX por este tipo de coluna é exibido abaixo:
<asp:GridView
ID="GridView1"
runat="server"
DataSourceID="SqlDataSource1"
AutoGenerateColumns="False"
DataKeyNames="UsuarioID">
<Columns>
<asp:CommandField
ShowDeleteButton="True"
ShowEditButton="True"
ShowSelectButton="True" />
</Columns>
</asp:GridView>
|
|
ASPX
|
|
Abaixo é mostrado uma listagem com as principais propriedades da coluna CommandField:
|
Propriedade
|
Descrição
|
ShowCancelButton
|
Exibe ou oculta o Button para cancelar.
|
ShowDeleteButton
|
Exibe ou oculta o Button para exclusão.
|
ShowEditButton
|
Exibe ou oculta o Button para edição.
|
ShowInsertButton
|
Exibe ou oculta o Button para inserção.
|
ShowSelectButton
|
Exibe ou oculta o Button para seleção.
|
|
TemplateField
Caso nenhuma das colunas apresentadas anteriormente satisfaça a necessidade, podemos optar pela criação de uma TemplateField ou TemplateColumn, como também é conhecida. Este tipo de coluna permite customizá-la, incluindo qualquer tipo de formatação ou controle.
O código HTML gerado na página ASPX por este tipo de coluna é exibido abaixo:
<asp:GridView
ID="GridView1"
runat="server"
DataSourceID="SqlDataSource1"
AutoGenerateColumns="False"
DataKeyNames="UsuarioID">
<Columns>
<asp:TemplateField>
<ItemTemplate>
<asp:RadioButton
ID="RadioButton1"
runat="server" />
</ItemTemplate>
</asp:TemplateField>
</Columns>
</asp:GridView>
|
|
ASPX
|
|
|