BindingSource Classe

Definição

Encapsula a fonte de dados de um formulário.Encapsulates the data source for a form.

public ref class BindingSource : System::ComponentModel::Component, System::Collections::IList, System::ComponentModel::IBindingListView, System::ComponentModel::ICancelAddNew, System::ComponentModel::ISupportInitializeNotification, System::ComponentModel::ITypedList, System::Windows::Forms::ICurrencyManagerProvider
[System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
public class BindingSource : System.ComponentModel.Component, System.Collections.IList, System.ComponentModel.IBindingListView, System.ComponentModel.ICancelAddNew, System.ComponentModel.ISupportInitializeNotification, System.ComponentModel.ITypedList, System.Windows.Forms.ICurrencyManagerProvider
type BindingSource = class
    inherit Component
    interface IBindingListView
    interface IBindingList
    interface IList
    interface ICollection
    interface IEnumerable
    interface ITypedList
    interface ICancelAddNew
    interface ISupportInitializeNotification
    interface ISupportInitialize
    interface ICurrencyManagerProvider
Public Class BindingSource
Inherits Component
Implements IBindingListView, ICancelAddNew, ICurrencyManagerProvider, IList, ISupportInitializeNotification, ITypedList
Herança
Atributos
Implementações

Exemplos

O exemplo de código a seguir ListBox demonstra um associado BindingSourcea um.The following code example demonstrates a ListBox bound to a BindingSource. O BindingSource é associado a um BindingList<T> que contém uma lista de fontes.The BindingSource is bound to a BindingList<T> that contains a list of fonts.

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;
        }


    }
  
}
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Drawing
Imports System.Text
Imports System.Windows.Forms
Public Class Form1
    Inherits Form

    <STAThread()> _
    Shared Sub Main()
        Application.EnableVisualStyles()
        Application.Run(New Form1())

    End Sub

    Public Sub New()

    End Sub

    Private textBox1 As TextBox
    Private WithEvents button1 As Button
    Private listBox1 As ListBox
    Private components As IContainer
    Private binding1 As BindingSource

    Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        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"
        Me.ClientSize = New Size(292, 266)
        Me.Controls.Add(Me.button1)
        Me.Controls.Add(Me.textBox1)
        Me.Controls.Add(Me.listBox1)

        Dim fonts As New MyFontList()
        Dim i As Integer
        For i = 0 To FontFamily.Families.Length - 1
            If FontFamily.Families(i).IsStyleAvailable(FontStyle.Regular) Then
                fonts.Add(New Font(FontFamily.Families(i), 11.0F, FontStyle.Regular))
            End If
        Next i
        binding1.DataSource = fonts
        listBox1.DataSource = binding1
        listBox1.DisplayMember = "Name"

    End Sub
    Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
        Handles button1.Click

        If binding1.SupportsSearching <> True Then
            MessageBox.Show("Cannot search the list.")
        Else
            Dim foundIndex As Integer = binding1.Find("Name", textBox1.Text)
            If foundIndex > -1 Then
                listBox1.SelectedIndex = foundIndex
            Else
                MessageBox.Show("Font was not found.")
            End If
        End If

    End Sub
End Class

Public Class MyFontList
    Inherits BindingList(Of Font)

    Protected Overrides ReadOnly Property SupportsSearchingCore() As Boolean
        Get
            Return True
        End Get
    End Property
    
    Protected Overrides Function FindCore(ByVal prop As PropertyDescriptor, _
        ByVal key As Object) As Integer
        ' Ignore the prop value and search by family name.
        Dim i As Integer
        While i < Count
            If Items(i).FontFamily.Name.ToLower() = CStr(key).ToLower() Then
                Return i
            End If
            i += 1
        End While

        Return -1
    End Function
End Class

Comentários

O BindingSource componente atende a muitos propósitos.The BindingSource component serves many purposes. Primeiro, ele simplifica os controles de associação em um formulário para os dados fornecendo gerenciamento de moedas, notificação de alteração e outros serviços entre Windows Forms controles e fontes de dados.First, it simplifies binding controls on a form to data by providing currency management, change notification, and other services between Windows Forms controls and data sources. Isso é feito anexando o BindingSource componente à fonte de dados usando a DataSource propriedade.This is accomplished by attaching the BindingSource component to your data source using the DataSource property. Para cenários de associação complexos, você pode, opcionalmente, definir a DataMember Propriedade como uma coluna ou lista específica na fonte de dados.For complex binding scenarios you can optionally set the DataMember property to a specific column or list in the data source. Em seguida, você associa controles BindingSourceao.You then bind controls to the BindingSource. Todas as outras interações com os dados são realizadas com chamadas BindingSource para o componente.All further interaction with the data is accomplished with calls to the BindingSource component. Para obter exemplos de como BindingSource o pode simplificar o processo de ligação, consulte Como: Associar controles de Windows Forms a valores de banco de dados DBNull e como: Manipule erros e exceções que ocorrem com DataBinding.For examples on how the BindingSource can simplify the binding process, see How to: Bind Windows Forms Controls to DBNull Database Values and How to: Handle Errors and Exceptions that Occur with Databinding. A navegação e a atualização da fonte de dados são realizadas por meio MoveNextde MoveLastmétodos como Remove, e.Navigation and updating of the data source is accomplished through methods such as MoveNext, MoveLast, and Remove. Operações como classificação e filtragem são manipuladas por meio Sort das Filter Propriedades e.Operations such as sorting and filtering are handled through the Sort and Filter properties. Para obter mais informações sobre como usar classificação e filtragem BindingSourcecom o , consulte Como: Classifique e filtre dados do ADO.NET com o componenteWindows Forms BindingSource.For more information on using sorting and filtering with the BindingSource, see How to: Sort and Filter ADO.NET Data with the Windows Forms BindingSource Component.

Além disso, o BindingSource componente pode atuar como uma fonte de dados fortemente tipada.In addition, the BindingSource component can act as a strongly typed data source. Normalmente, o tipo da fonte de dados subjacente é corrigido por meio de um dos seguintes mecanismos:Typically the type of the underlying data source is fixed through one of the following mechanisms:

  • Use o Add método para adicionar um item BindingSource ao componente.Use the Add method to add an item to the BindingSource component.

  • Defina a DataSource Propriedade como uma lista, um único objeto ou um tipo.Set the DataSource property to a list, single object, or type.

Ambos os mecanismos criam uma lista fortemente tipada.Both of these mechanisms create a strongly-typed list. Para obter mais informações sobre como usar o BindingSource para associar a um tipo, consulte como: Associar um controle de Windows Forms a umtipo.For more information on how to use the BindingSource to bind to a type, see How to: Bind a Windows Forms Control to a Type. Você também pode usar o BindingSource para associar os controles a um objeto de fábrica.You can also use the BindingSource to bind your controls to a factory object. Para obter mais informações sobre como fazer isso, consulte como: Associar um controle de Windows Forms a um objetode fábrica.For more information on how to do this, see How to: Bind a Windows Forms Control to a Factory Object.

Observação

Como um BindingSource identificador de fontes de dados simples e complexas, a terminologia é problemática.Because a BindingSource handles both simple and complex data sources, terminology is problematic. Dentro desta documentação de classe, a lista de termos se refere a uma coleção de dados na fonte de dados hospedada e o Item denota um único elemento.Within this class documentation, the term list refers to a data collection within the hosted data source, and item denotes a single element. Ao discutir a funcionalidade associada a fontes de dados complexas, a linha e a tabela de termos equivalentes são usados.When discussing functionality associated with complex data sources, the equivalent terms table and row are used.

BindingSourcefornece membros para acessar os dados subjacentes.BindingSource provides members for accessing the underlying data. O item atual pode ser recuperado por meio Current da propriedade e toda a lista pode ser recuperada por List meio da propriedade.The current item can be retrieved through the Current property, and the entire list can be retrieved through the List property. As operações de edição têm suporte no item atual Current por meio RemoveCurrentdos EndEditmétodos CancelEdit , Add e AddNew e.Editing operations are supported on the current item through Current and the RemoveCurrent, EndEdit, CancelEdit and Add and AddNew methods. Embora o gerenciamento de moedas seja manipulado automaticamente para todos os tipos de fonte de dados subjacentes, essa classe expõe CurrentItemChanged vários DataSourceChangedeventos, como e, que permitem a personalização.Although currency management is handled automatically for all underlying data source types, this class exposes a number of events, such as CurrentItemChanged and DataSourceChanged, that allow for customization.

As fontes de dados associadas a um BindingSource componente também podem ser navegadas e gerenciadas com BindingNavigator a classe, que fornece uma interface do usuário (IU) do tipo VCR para a navegação de itens dentro de uma lista.Data sources that are bound to a BindingSource component can also be navigated and managed with the BindingNavigator class, which provides a VCR-like user interface (UI) for navigating items within a list. Embora BindingNavigator possa ser associado a qualquer fonte de dados, ele foi projetado para se integrar BindingSource a um componente BindingNavigator.BindingSource por meio de sua propriedade.Although BindingNavigator can be bound to any data source, it was designed to integrate with a BindingSource component through its BindingNavigator.BindingSource property.

A propriedade padrão para a BindingSource classe é DataSource.The default property for the BindingSource class is DataSource. O evento padrão é CurrentChanged.The default event is CurrentChanged.

Cuidado

Muitos dos membros da BindingSource classe operam na lista subjacente representada List pela propriedade e simplesmente consultam sua operação à lista subjacente.Many of the members of the BindingSource class operate on the underlying list represented by the List property and simply refer their operation to the underlying list. Portanto, quando o BindingSource está associado a uma implementação personalizada do IList, o comportamento exato desses membros pode ser diferente do comportamento descrito na documentação da classe.Therefore, when the BindingSource is bound to a custom implementation of IList, the exact behavior of these members may differ from the behavior described in the class documentation. Por exemplo, o RemoveAt método chama IList.RemoveAt.For example, the RemoveAt method calls IList.RemoveAt. A BindingSource documentação descreve o RemoveAt método com a compreensão de que RemoveAt o método para o IList subjacente está implementado corretamente.The BindingSource documentation describes the RemoveAt method with the understanding that the RemoveAt method for the underlying IList is correctly implemented.

Construtores

BindingSource()

Inicializa uma nova instância da classe BindingSource com os valores da propriedade padrão.Initializes a new instance of the BindingSource class to the default property values.

BindingSource(IContainer)

Inicializa uma nova instância da classe BindingSource e adiciona o BindingSource ao contêiner especificado.Initializes a new instance of the BindingSource class and adds the BindingSource to the specified container.

BindingSource(Object, String)

Inicializa uma nova instância da classe BindingSource com a fonte de dados e o membro de dados especificados.Initializes a new instance of the BindingSource class with the specified data source and data member.

Propriedades

AllowEdit

Obtém um valor que indica se os itens da lista subjacente podem ser editados.Gets a value indicating whether items in the underlying list can be edited.

AllowNew

Obtém ou define um valor que indica se o método AddNew() pode ser usado para adicionar itens à lista.Gets or sets a value indicating whether the AddNew() method can be used to add items to the list.

AllowRemove

Obtém um valor que indica se itens podem ser removidos da lista subjacente.Gets a value indicating whether items can be removed from the underlying list.

CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Herdado de Component)
Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Herdado de Component)
Count

Obtém o número total de itens na lista subjacente, levando o valor Filter atual em consideração.Gets the total number of items in the underlying list, taking the current Filter value into consideration.

CurrencyManager

Obtém o gerenciador de moeda associado a este BindingSource.Gets the currency manager associated with this BindingSource.

Current

Obtém o item atual na lista.Gets the current item in the list.

DataMember

Obtém ou define a lista específica na fonte de dados à qual o conector está atualmente associado.Gets or sets the specific list in the data source to which the connector currently binds to.

DataSource

Obtém ou define a fonte de dados a que o conector é associado.Gets or sets the data source that the connector binds to.

DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Herdado de Component)
Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Herdado de Component)
Filter

Obtém ou define a expressão usada para filtrar quais linhas são exibidas.Gets or sets the expression used to filter which rows are viewed.

IsBindingSuspended

Obtém um valor que indica se a associação da lista está suspensa.Gets a value indicating whether the list binding is suspended.

IsFixedSize

Obtém um valor que indica se a lista subjacente tem um tamanho fixo.Gets a value indicating whether the underlying list has a fixed size.

IsReadOnly

Obtém um valor que indica se a lista subjacente é somente leitura.Gets a value indicating whether the underlying list is read-only.

IsSorted

Obtém um valor que indica se os itens da lista subjacente estão classificados.Gets a value indicating whether the items in the underlying list are sorted.

IsSynchronized

Obtém um valor que indica se o acesso à coleção é sincronizado (thread-safe).Gets a value indicating whether access to the collection is synchronized (thread safe).

Item[Int32]

Obtém ou define o elemento da lista no índice especificado.Gets or sets the list element at the specified index.

List

Obtém a lista a qual o conector está associado.Gets the list that the connector is bound to.

Position

Obtém ou define o índice do item atual na lista subjacente.Gets or sets the index of the current item in the underlying list.

RaiseListChangedEvents

Obtém ou define um valor que indica se os eventos ListChanged devem ser gerados.Gets or sets a value indicating whether ListChanged events should be raised.

Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Herdado de Component)
Sort

Obtém ou define os nomes de coluna usados para classificação e a ordem de classificação para exibir as linhas na fonte de dados.Gets or sets the column names used for sorting, and the sort order for viewing the rows in the data source.

SortDescriptions

Obtém a coleção de descrições de classificação aplicadas à fonte de dados.Gets the collection of sort descriptions applied to the data source.

SortDirection

Obtém a direção em que os itens na lista são classificados.Gets the direction the items in the list are sorted.

SortProperty

Obtém o PropertyDescriptor que está sendo usado para classificar a lista.Gets the PropertyDescriptor that is being used for sorting the list.

SupportsAdvancedSorting

Obtém um valor que indica se a fonte de dados dá suporte à classificação de várias colunas.Gets a value indicating whether the data source supports multi-column sorting.

SupportsChangeNotification

Obtém um valor que indica se a fonte de dados dá suporte à notificação de alteração.Gets a value indicating whether the data source supports change notification.

SupportsFiltering

Obtém um valor que indica se a fonte de dados dá suporte à filtragem.Gets a value indicating whether the data source supports filtering.

SupportsSearching

Obtém um valor que indica se a fonte de dados é compatível com a pesquisa com o método Find(PropertyDescriptor, Object).Gets a value indicating whether the data source supports searching with the Find(PropertyDescriptor, Object) method.

SupportsSorting

Obtém um valor que indica se a fonte de dados dá suporte à classificação.Gets a value indicating whether the data source supports sorting.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à lista subjacente.Gets an object that can be used to synchronize access to the underlying list.

Métodos

Add(Object)

Adiciona um item existente à lista interna.Adds an existing item to the internal list.

AddNew()

Adiciona um novo item à lista subjacente.Adds a new item to the underlying list.

ApplySort(ListSortDescriptionCollection)

Classifica a fonte de dados com as descrições de classificação especificadas.Sorts the data source with the specified sort descriptions.

ApplySort(PropertyDescriptor, ListSortDirection)

Classifica a fonte de dados usando a direção de classificação e o descritor de propriedade especificados.Sorts the data source using the specified property descriptor and sort direction.

CancelEdit()

Cancela a operação de edição atual.Cancels the current edit operation.

Clear()

Remove todos os elementos da lista.Removes all elements from the list.

Contains(Object)

Determina se um objeto é um item na lista.Determines whether an object is an item in the list.

CopyTo(Array, Int32)

Copia o conteúdo do List para a matriz especificada, começando no valor de índice especificado.Copies the contents of the List to the specified array, starting at the specified index value.

CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Herdado de Component)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo BindingSource e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the BindingSource and optionally releases the managed resources.

EndEdit()

Aplica as alterações pendentes à fonte de dados subjacente.Applies pending changes to the underlying data source.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
Find(PropertyDescriptor, Object)

Pesquisa o índice do item que tem o descritor de propriedade especificado.Searches for the index of the item that has the given property descriptor.

Find(String, Object)

Retorna o índice do item na lista com o nome e valor da propriedade especificada.Returns the index of the item in the list with the specified property name and value.

GetEnumerator()

Recupera um enumerador para o List.Retrieves an enumerator for the List.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetItemProperties(PropertyDescriptor[])

Recupera uma matriz de objetos PropertyDescriptor que representa as propriedades vinculáveis do tipo de lista da fonte de dados.Retrieves an array of PropertyDescriptor objects representing the bindable properties of the data source list type.

GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetListName(PropertyDescriptor[])

Obtém o nome da lista fornecendo os dados para a associação.Gets the name of the list supplying data for the binding.

GetRelatedCurrencyManager(String)

Obtém o gerenciador de moeda relacionado para o membro de dados especificado.Gets the related currency manager for the specified data member.

GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IndexOf(Object)

Pesquisa o objeto especificado e retorna o índice da primeira ocorrência dentro de toda a lista.Searches for the specified object and returns the index of the first occurrence within the entire list.

InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
Insert(Int32, Object)

Insere um item na lista no índice especificado.Inserts an item into the list at the specified index.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
MoveFirst()

Move para o primeiro item na lista.Moves to the first item in the list.

MoveLast()

Move para o último item na lista.Moves to the last item in the list.

MoveNext()

Move para o próximo item na lista.Moves to the next item in the list.

MovePrevious()

Move para o item anterior na lista.Moves to the previous item in the list.

OnAddingNew(AddingNewEventArgs)

Aciona o evento AddingNew.Raises the AddingNew event.

OnBindingComplete(BindingCompleteEventArgs)

Aciona o evento BindingComplete.Raises the BindingComplete event.

OnCurrentChanged(EventArgs)

Aciona o evento CurrentChanged.Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs)

Aciona o evento CurrentItemChanged.Raises the CurrentItemChanged event.

OnDataError(BindingManagerDataErrorEventArgs)

Aciona o evento DataError.Raises the DataError event.

OnDataMemberChanged(EventArgs)

Aciona o evento DataMemberChanged.Raises the DataMemberChanged event.

OnDataSourceChanged(EventArgs)

Aciona o evento DataSourceChanged.Raises the DataSourceChanged event.

OnListChanged(ListChangedEventArgs)

Aciona o evento ListChanged.Raises the ListChanged event.

OnPositionChanged(EventArgs)

Aciona o evento PositionChanged.Raises the PositionChanged event.

Remove(Object)

Remove o item especificado da lista.Removes the specified item from the list.

RemoveAt(Int32)

Remove o item no índice especificado da lista.Removes the item at the specified index in the list.

RemoveCurrent()

Remove o item atual da lista.Removes the current item from the list.

RemoveFilter()

Remove o filtro associado ao BindingSource.Removes the filter associated with the BindingSource.

RemoveSort()

Remove a classificação associada ao BindingSource.Removes the sort associated with the BindingSource.

ResetAllowNew()

Reinicializa a propriedade AllowNew.Reinitializes the AllowNew property.

ResetBindings(Boolean)

Faz com que um controle associado ao BindingSource releia todos os itens na lista e atualize os valores exibidos.Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.

ResetCurrentItem()

Faz com que um controle associado ao BindingSource releia o item selecionado no momento e atualize seu valor exibido.Causes a control bound to the BindingSource to reread the currently selected item and refresh its displayed value.

ResetItem(Int32)

Faz com que um controle associado ao BindingSource releia o item no índice especificado e atualize o valor exibido.Causes a control bound to the BindingSource to reread the item at the specified index, and refresh its displayed value.

ResumeBinding()

Retome a vinculação de dados.Resumes data binding.

SuspendBinding()

Suspende a vinculação de dados para evitar alterações de atualização da fonte de dados associada.Suspends data binding to prevent changes from updating the bound data source.

ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(Herdado de Component)

Eventos

AddingNew

Ocorre antes que um item seja adicionado à lista subjacente.Occurs before an item is added to the underlying list.

BindingComplete

Ocorre quando todos os clientes foram vinculados a esse BindingSource.Occurs when all the clients have been bound to this BindingSource.

CurrentChanged

Ocorre quando o item associado no momento é alterado.Occurs when the currently bound item changes.

CurrentItemChanged

Ocorre quando o valor da propriedade Current foi alterado.Occurs when a property value of the Current property has changed.

DataError

Ocorre quando uma exceção relacionada à moeda é tratada silenciosamente pelo BindingSource.Occurs when a currency-related exception is silently handled by the BindingSource.

DataMemberChanged

Ocorre quando o valor da propriedade DataMember é alterado.Occurs when the DataMember property value has changed.

DataSourceChanged

Ocorre quando o valor da propriedade DataSource é alterado.Occurs when the DataSource property value has changed.

Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Herdado de Component)
ListChanged

Ocorre quando a lista subjacente muda ou um item na lista é alterado.Occurs when the underlying list changes or an item in the list changes.

PositionChanged

Ocorre depois que o valor da propriedade Position é alterado.Occurs after the value of the Position property has changed.

Implantações explícitas de interface

IBindingList.AddIndex(PropertyDescriptor)

Adiciona o PropertyDescriptor aos índices usados para pesquisa.Adds the PropertyDescriptor to the indexes used for searching.

IBindingList.RemoveIndex(PropertyDescriptor)

Remove o PropertyDescriptor dos índices usados para pesquisa.Removes the PropertyDescriptor from the indexes used for searching.

ICancelAddNew.CancelNew(Int32)

Descarta um novo item pendente da coleção.Discards a pending new item from the collection.

ICancelAddNew.EndNew(Int32)

Confirma um novo item pendente para a coleção.Commits a pending new item to the collection.

ISupportInitialize.BeginInit()

Sinaliza o BindingSource de que a inicialização está sendo iniciada.Signals the BindingSource that initialization is starting.

ISupportInitialize.EndInit()

Sinaliza o BindingSource de que a inicialização está concluída.Signals the BindingSource that initialization is complete.

ISupportInitializeNotification.Initialized

Ocorre quando a BindingSource é inicializada.Occurs when the BindingSource is initialized.

ISupportInitializeNotification.IsInitialized

Obtém um valor que indica se o BindingSource é inicializado.Gets a value indicating whether the BindingSource is initialized.

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também