BindingSource Classe

Definizione

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

public ref class BindingSource : System::ComponentModel::Component, System::Collections::IList, System::ComponentModel::IBindingListView, System::ComponentModel::ICancelAddNew, System::ComponentModel::ISupportInitialize, 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

[System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
public class BindingSource : System.ComponentModel.Component, System.Collections.IList, System.ComponentModel.IBindingListView, System.ComponentModel.ICancelAddNew, System.ComponentModel.ISupportInitialize, System.ComponentModel.ISupportInitializeNotification, System.ComponentModel.ITypedList, System.Windows.Forms.ICurrencyManagerProvider

[<System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")>]
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

[<System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")>]
type BindingSource = class
    inherit Component
    interface IBindingListView
    interface ICollection
    interface IEnumerable
    interface IList
    interface IBindingList
    interface ITypedList
    interface ICancelAddNew
    interface ISupportInitializeNotification
    interface ISupportInitialize
    interface ICurrencyManagerProvider

Public Class BindingSource
Inherits Component
Implements IBindingListView, ICancelAddNew, ICurrencyManagerProvider, IList, ISupportInitializeNotification, ITypedList

Public Class BindingSource
Inherits Component
Implements IBindingListView, ICancelAddNew, ICurrencyManagerProvider, IList, ISupportInitialize, ISupportInitializeNotification, ITypedList

Ereditarietà

Object

MarshalByRefObject

Component

BindingSource

Attributi

ComplexBindingPropertiesAttribute

Implementazioni

ICollection IEnumerable IList IBindingList IBindingListView ICancelAddNew ISupportInitialize ISupportInitializeNotification ITypedList ICurrencyManagerProvider

Esempio

Nell'esempio di codice seguente viene illustrato un ListBox limite a un BindingSourceoggetto . L'oggetto BindingSource è associato a un BindingList<T> oggetto contenente un elenco di tipi di carattere.

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

Commenti

Il BindingSource componente serve molti scopi. In primo luogo, semplifica i controlli di associazione in un modulo ai dati fornendo la gestione delle valute, la notifica delle modifiche e altri servizi tra controlli e origini dati Windows Forms. Questa operazione viene eseguita collegando il componente all'origine BindingSource dati usando la DataSource proprietà . Per scenari di associazione complessi, è possibile impostare facoltativamente la DataMember proprietà su una colonna o un elenco specifico nell'origine dati. Si associano quindi i controlli all'oggetto BindingSource. Tutte le ulteriori interazioni con i dati vengono eseguite con le chiamate al BindingSource componente. Per esempi su come BindingSource semplificare il processo di associazione, vedere Procedura: Associare controlli di Windows Forms ai valori del database DBNulle Procedura: Gestire errori ed eccezioni che si verificano con databinding. Lo spostamento e l'aggiornamento dell'origine dati vengono eseguiti tramite metodi come MoveNext, MoveLaste Remove. Le operazioni come l'ordinamento e il filtro vengono gestite tramite le Sort proprietà e Filter . Per altre informazioni sull'uso dell'ordinamento e del filtro con , BindingSourcevedere Procedura: Ordinare e filtrare i dati ADO.NET con il componente bindingsource Windows Forms.

Inoltre, il BindingSource componente può fungere da origine dati fortemente tipizzata. In genere il tipo dell'origine dati sottostante viene corretto tramite uno dei meccanismi seguenti:

• Utilizzare il Add metodo per aggiungere un elemento al BindingSource componente.

• Impostare la DataSource proprietà su un elenco, un singolo oggetto o un tipo.

Entrambi questi meccanismi creano un elenco fortemente tipizzato. Per altre informazioni su come usare l'oggetto BindingSource per associare a un tipo, vedere Procedura: Associare un controllo Windows Forms a un tipo. È anche possibile usare per BindingSource associare i controlli a un oggetto factory. Per altre informazioni su come eseguire questa operazione, vedere Procedura: Associare un controllo Windows Forms a un oggetto Factory.

BindingSource fornisce membri per l'accesso ai dati sottostanti. L'elemento corrente può essere recuperato tramite la Current proprietà e l'intero elenco può essere recuperato tramite la List proprietà . Le operazioni di modifica sono supportate nell'elemento corrente tramite e i RemoveCurrentmetodi , CancelEditEndEdite e AddAddNew.Current Anche se la gestione delle valute viene gestita automaticamente per tutti i tipi di origine dati sottostanti, questa classe espone un numero di eventi, ad esempio CurrentItemChanged e DataSourceChanged, che consentono la personalizzazione.

Le origini dati associate a un BindingSource componente possono anche essere spostate e gestite con la classe, che fornisce un'interfaccia utente simile al BindingNavigator registro virtuale per lo spostamento di elementi all'interno di un elenco. Anche se BindingNavigator può essere associata a qualsiasi origine dati, è stata progettata per l'integrazione con un BindingSource componente tramite la relativa BindingNavigator.BindingSource proprietà.

La proprietà predefinita per la BindingSource classe è DataSource. L'evento predefinito è CurrentChanged.

Costruttori

Proprietà

Metodi

Eventi

Implementazioni dell'interfaccia esplicita

Metodi di estensione

Si applica a

Vedi anche

• BindingSource
• BindingNavigator
• DataGridView
• CurrencyManager
• IList
• IBindingList
• IEditableObject
• Componente BindingSource