C# - DataGridView , BindingSource e BindingNavigator

Neste artigo veremos a utilização dos componentes BindingSource, BindingNavigator e DataGridView em aplicações C#.

Sabe porque é importante você conhecer estes componentes ?

O componente BindingSource oferece a maneira mais simples e fácil de navegar através de registros em uma fonte de dados; ele foi criado justamente para simplificar o processo de vinculação com os controles relacionados a uma fonte de dados.

Podemos fazer a vinculação do BindingSource qualquer um dos seguintes objetos/Interfaces:

ICollection , IList , IListSource, IBindingList e IBindingListViewObject ,  System.Type , IEnumerable ,

O componente BindingSource veio substituir o componente CurrencyManager, e, embora você ainda possa continuar usando o CurrencyManager, o BindingSource deve ter preferência quando houve a necessidade de vincular os controles de um formulário Windows a uma fonte de dados; dessa forma o componente BindingSource permite criar um vínculo entre os controles e a fonte de dados. Ele fornece as seguintes vantagens sobre as técnicas de vinculação anteriores:

• Encapsular a funcionalidade do CurrencyManager e expor os eventos do CurrencyManager em tempo de projeto;
• Interagir com outros controles windows forms relacionados como por exemplo o BindingNavigator e o DataGridView;

A propriedade DataSource é a propriedade padrão para a classe BindingSource e o evento padrão é o evento CurrentChanged. Além disso o BindingSource fornece métodos, propriedades e eventos como os eventos CurrentItemChanged e DataSourceChanged que permite uma certa customização.

A propriedade Positon obtêm ou define o índice para o item atual na fonte de dados atual enquanto que o método MoveLast() altera o valor atual da propriedade Position para o índice do último item na fonte de dados que é a mesma coisa que obter o valor pela propriedade Count. Ex: Count -1.

O item atual pode ser retornado através da propriedade Current, e lista inteira pode ser retornada através da propriedade List. 

As operações de edição são suportadas no item atual através dos métodos : Current , RemoveCurrent, EndEdit, CancelEdit, Add e AddNew.

Embora o tratamento de valores atualizados é feito automaticamente para todos os tipos de fonte de dados, a classe fornece os eventos CurrentItemChanged and DataSourceChanged, que permitem uma customização.

A fonte de dados que são vinculadas ao BindingSource podem ser percorridas e gerenciadas com a classe BindingNavigator que fornece uma interface para navegação pelos itens da lista. Embora o BindingNavigator possa ser vinculado a qualquer fonte de dados ele foi criado para ser integrado com o BindingSource através da propriedade BindingNavigator.BindingSource

Muitos membros da classe BindingSource operam na lista relacionada representada pela propriedade List, e, simplesmente referencia suas operações para lista relacionada. Desta forma quando o BindingSource esta vinculado a uma implementação customizada de IList, o comportamento dos membros podem diferir do comportamento descrito na documentação da classe.  Assim, o método RemoveAt chama IList.RemoveAt. Na documentação o método RemoveAt é descrito considerando que a implementação de IList foi corretamente implementada.

A propriedade padrão para a classe  BindingSource  é DataSource e o evento padrão é CurrentChanged.

Nota: Como o BindingSource suporta a vinculação a fonte de dados simples e a complexas, a terminologia pode ser confusa. O temo list refere-se a coleção de dados da fonte de dados , item denota um simples elemento. Para fonte de dados complexas os termos equivalentes table e row são usados

//vincular o BindingSource a um componente DataGridView
this.DataGridView1.DataSource = this.clientesBindingSource1;

//obter o número total de items em uma fonte de dados
int count = this.clientesBindingSource.Count;

//obtem ou define um indice para o item atual
int pos = this.clientesBindingSource1.Position;

//move para o último item na lista
this.bindingSource1.Position = this.bindingSource1.Count - 1;

ou

//move para o último item na lista
this.bindingSource1.Position = this.bindingSource1.MoveLast();

Usando BindingSource, BindingNavigator e DataGridView

Veremos agora um exemplo prático usando estes componentes e algumas de suas propriedades e métodos.

Se você deseja navegar através dos registros de uma fontes de dados basta vincular o componente BindingSource a fonte de dados e em seguida vincular os controles do formulário (TextBox) ao controle BindingSource. Assim poderemos usar os métodos : MoveNext(), MovePrevious(), MoveFirst(), and MoveLast() para realizar tal tarefa.

Para o exemplo deste artigo eu vou usar um banco de dados Microsoft Access que foi criado com o nome Cadastro.mdb  que estará em uma pasta c:\dados e uma tabela Clientes com a seguinte estrutura:

 Abra o Visual C# 2008 Express Edition ou o SharpDevelop 2.2 e crie uma nova aplicação do tipo Windows com o nome DataGridViewBinding;

 Neste ponto se você selecionar no menu Data a opção Add New Data Source e estabelecer uma conexão com o banco de dados Cadastro.mdb, selecionar um DataSet e escolher a tabela Clientes você criará um DataSet e a partir da janela DataSource poderá selecionar os campos e arrastar para o formulário criando assim de forma automática toda a interface para navegação pelos registros da tabela e o acesso ao banco de dados conforme pode ser visto na figura abaixo:

Observe que são criados de forma automática os objetos TableAdapter, BindingSource e BindingNavigator além do DataSet.

Mas não é isso que queremos mostrar. Queremos mostrar outra forma de obter o mesmo resultado e aproveitar e para mostrar como os componentes  BindingSource e BindingNavigator trabalham em conjunto.

Nosso objetivo será:

• Obter os dados da tabela Clientes do banco de dados Cadastro.mdb;
• Exibir os dados em um controle DataGridView;

Vamos limpar o projeto e ficar somente com o formulário form1.cs. Agora a partir da ToolBox inclua os seguintes controles no formulário:

• Inclua o controle DataGridView no formulário form1.cs a partir da ToolBox e não use assistente que será aberto para selecionar um Data Source;

Vamos agora ao código do formulário clicando na opção View Code.

A primeira coisa que temos que definir é a conexão com o banco de dados, no exemplo estou usando um banco de dados Access, mas poderia usar o SQL Server.

Vamos incluir então no início do código do formulário a linha de código abaixo para podermos usar as classes para efetuar a conexão com o banco de dados Cadastro.mdb;

using System.Data.OleDb;

A seguir no interior da seção :

public partial class Form1 : Form
{

Vamos incluir o código a seguir onde estaremos definindo um objeto do tipo BindingSource:

BindingSource bs = new BindingSource();

Iremos atribuir os dados obtidos do banco de dados para o objeto bs e assim o DataGridView e o BindingNavigator podem usá-lo como fonte de dados.

Vamos agora extrair os dados da nossa base de dados.

Vamos usar o evento Load do formulário para efetuar a conexão com o banco de dados usando a seguinte linha de código:

OleDbConnection myConn = new OleDbConnection ("Provider=Microsoft.Jet.OleDb.4.0; Data Source=c:/dados/Cadastro.mdb");

Nota: O provedor para um banco de dados Access pode ser definido assim:

"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=seu.mdb;Jet OLEDB:Database Password=suasenha;";

Como tratar com banco de dados sempre é uma tarefa sujeita a erros vamos usar o bloco Try/Catch/Finally para tratar eventuais erros usando o seguinte código:

Executando o projeto iremos obter o seguinte:

Agora vamos usar um recurso do BindingSource para filtrar os dados na exibição do DataGridView. Inclua um controle Combobox no formulário e ativando o ComboBox Tasks clique no link Edit Items e informe os valores 10, 20, 30 e 40.  Inclua uma Label com o texto : Exibir Clientes com idade menor ou igual a:

Agora no evento SelectedIndexChanged do Combobox inclua o código abaixo onde estamos usando a propriedade Filter do BindingSource.

A propriedade Filter obtém ou define a expressão usada para filtrar quais linhas serão exibidas.

Executando o projeto iremos obter :

Inclua também um botão de comando no formulário e no seu evento Click inclua o código para remover o filtro aplicado usando a propriedade RemoveFilter:

Ao clicar no botão o filtro será removido e todos os dados serão exibidos novamente.

Podermos implementar outros filtros, como por exemplo filtrar por nome de forma que ao digitar os caracteres de um nome em uma caixa de texto os dados serão sendo filtrados e exibidos dinamicamente no DataGridView.

Para implementar este recurso inclua uma Label com o texto : Filtrar por nome e um TextBox - txtNome - no formulário form1.cs e no evento TextChanged do TextBox inclua o código abaixo que usar a propriedade Filter:

Executando projeto e digitando as letras Ma teremos:

Você pode aplicar um filtro e sobre os dados filtrados aplicar outro filtro obtendo assim como resultado os dados que foram filtrados por critérios distintos em duas etapas. No exemplo você pode filtrar a idade primeiro e depois filtrar por nome.

Podemos ainda efetuar combinações de condições para criar um filtro com múltiplos critérios sendo aplicados de uma vez. No exemplo acima podemos definir um critério para filtrar por idade e por cidade.

Vamos então incluir um controle GroupBox e no seu interior dois controles Label : Cidade e Idade e dois TextBox : txtCidade e txtIdade e um Button - btnFiltrar. Defina o leiaute conforme a figura abaixo:

 No evento Click do botão de comando Aplicar Filtro inclua o código abaixo que aplica o filtro usando dois critérios:

1. Cidade que contenha o caractere digitado;
2. E idade maior que a informada;

Executando o projeto e aplicando o filtro para os dois critérios definidos teremos exibidos os clientes cuja idade for maior que 25 e que a cidade inicie com San;

Como o foco é mostrar como usar a propriedade Filter do BindingSource eu não estou efetuando validações, o que deve ser feito em uma aplicação de produção.

Pegue o projeto completo aqui: DataGridViewBinding.zip

Eu sei é apenas C# , mas eu gosto...

Referências:

• http://msdn.microsoft.com/pt-br/library/system.windows.forms.bindingnavigator.aspx
• http://msdn.microsoft.com/en-us/library/system.windows.forms.bindingsource.aspx
• http://msdn.microsoft.com/pt-br/library/system.windows.forms.bindingsource.filter.aspx

• Vinculando dados ao DataGridView

• Filtrando e Ordenando com ADO.NET

• Manipulando o DataGridView

• DataBinding Revisitado

• Criando uma aplicação Windows Completa

José Carlos Macoratti