Classe BindingSource

O BindingSource componente serve a muitas finalidades. Primeiro, ele simplifica ligação controles em um formulário aos dados fornecendo gerenciamento corrente, notificação de alteração e outros serviços entre Formulários do Windows Fontes controles e dados. Isso é feito, anexando o BindingSource componente sua fonte de dados usando o DataSource propriedade. Para cenários de ligação complexos, opcionalmente, você pode definir a DataMember propriedade para uma coluna específica ou a lista de fonte de dados. Você, em seguida, vincula controles a BindingSource. Toda a interação com os dados mais é obtida com chamadas para o BindingSource componente. Para obter exemplos de como o BindingSource pode simplificar o processo de ligação, consulte Como: vincular controles Windows Forms a valores de banco de dados DBNull e Como: tratar erros e exceções que ocorrem com ligação de dados. Navegação e a atualização da fonte de dados é realizada através de métodos, como MoveNext, MoveLast, e Remove. Operações como, por exemplo, classificação e filtragem são manipuladas através do Sort e Filter propriedades. Para obter mais informações sobre como usar a classificação e filtragem com o BindingSource, consulte Como: classificar e filtrar dados ADO.NET com o componente BindingSource do Windows Forms.

Além disso, o BindingSource componente pode atuar como uma fonte de dados com rigidez de tipos. Normalmente, o tipo de fonte de dados subjacente é corrigido por meio de um dos mecanismos a seguir:

• Use o Add método para adicionar um item para o BindingSource componente.

• Definir o DataSource propriedade para uma lista, um único objeto ou um tipo.

Ambos esses mecanismos de criar uma lista com rigidez de tipos. Para obter mais informações sobre como usar o BindingSource para vincular a um tipo, consulte Como: ligar um controle Windows Forms a um tipo. Você também pode usar o BindingSource para ligar os controles a um objeto de fábrica. Para obter mais informações sobre como fazer isso, consulte Como: ligar um controle Windows Forms a um objeto de fábrica.

Observação
Porque um BindingSource alças de ambas as fontes de dados simples e complexa, terminologia é problemática. Dentro desta documentação de classe, o termo lista se refere a uma coleção de dados na fonte de dados hospedado, e item indica um único elemento. Quando discutir funcionalidade associadas com fontes de dados complexos, os termos equivalentes tabela e linha são usados.

BindingSource fornece a membros para acessar os dados subjacentes. O item atual pode ser recuperado através de Current propriedade e a lista inteira podem ser recuperado por meio do List propriedade. Operações de edição são compatíveis com o item atual por meio de Current e o RemoveCurrent, EndEdit, CancelEdit e Add e AddNew métodos. Embora o gerenciamento de moeda é manipulado automaticamente para todos os tipos de fonte de dados subjacente, essa classe expõe um número de eventos, tais como CurrentItemChanged e DataSourceChanged, que permitem a personalização.

Fontes de dados que são vinculados a um BindingSource componente também pode ser navegado e gerenciado com o BindingNavigator classe, que fornece uma interface de usuário VCR semelhante (UI) para navegar pelos itens de uma lista. Embora BindingNavigator pode ser vinculado a qualquer fonte de dados, ele foi projetado para integrar com um BindingSource componente por meio de sua BindingNavigator.BindingSource propriedade.

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

Cuidado

Muitos dos membros da BindingSource classe operam sobre a lista subjacente representada pela List propriedade e simplesmente consultar sua operação para a lista subjacente. Portanto, quando o BindingSource está vinculado a uma implementação personalizada do IList, o comportamento exato desses membros pode ser diferente do comportamento descrito na documentação da classe. Por exemplo, o RemoveAt chamadas de método IList.RemoveAt. O BindingSource documentação descreve o RemoveAt método com o entendimento de que o RemoveAt método para base IList é implementada corretamente.

O exemplo de código a seguir demonstra um ListBox acoplado a um BindingSource. O BindingSource está vinculado a um BindingList<T> que contém uma lista de fontes.

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Text;
using System.Windows.Forms;

namespace BindingSourceExamples
{
    public class Form1 : Form
    {
        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }

        public Form1()
        {
            this.Load += new EventHandler(Form1_Load);
        }

        private TextBox textBox1;
        private Button button1;
        private ListBox listBox1;

        private BindingSource binding1;
        void Form1_Load(object sender, EventArgs e)
        {
            listBox1 = new ListBox();
            textBox1 = new TextBox();
            binding1 = new BindingSource();
            button1 = new Button();
            listBox1.Location = new Point(140, 25);
            listBox1.Size = new Size(123, 160);
            textBox1.Location = new Point(23, 70);
            textBox1.Size = new Size(100, 20);
            textBox1.Text = "Wingdings";
            button1.Location = new Point(23, 25);
            button1.Size = new Size(75, 23);
            button1.Text = "Search";
            button1.Click += new EventHandler(this.button1_Click);
            this.ClientSize = new Size(292, 266);
            this.Controls.Add(this.button1);
            this.Controls.Add(this.textBox1);
            this.Controls.Add(this.listBox1);

            MyFontList fonts = new MyFontList();
            for (int i = 0; i < FontFamily.Families.Length; i++)
            {
                if (FontFamily.Families[i].IsStyleAvailable(FontStyle.Regular))
                    fonts.Add(new Font(FontFamily.Families[i], 11.0F, FontStyle.Regular));
            }
            binding1.DataSource = fonts;
            listBox1.DataSource = binding1;
            listBox1.DisplayMember = "Name";

        }


        private void button1_Click(object sender, EventArgs e)
        {
            if (binding1.SupportsSearching != true)
                MessageBox.Show("Cannot search the list.");
            else
            {
                int foundIndex = binding1.Find("Name", textBox1.Text);
                if (foundIndex > -1)
                    listBox1.SelectedIndex = foundIndex;
                else
                    MessageBox.Show("Font was not found.");
            }
        }
    }

    public class MyFontList : BindingList<Font>
    {

        protected override bool SupportsSearchingCore
        {
            get { return true; }
        }
        protected override int FindCore(PropertyDescriptor prop, object key)
        {
            // Ignore the prop value and search by family name.
            for (int i = 0; i < Count; ++i)
            {
                if (Items[i].FontFamily.Name.ToLower() == ((string)key).ToLower())
                    return i;

            }
            return -1;
        }


    }

}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

Referência

Outros recursos