BindingSource Klas

Definitie

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

Overname

Object

MarshalByRefObject

Component

BindingSource

Kenmerken

ComplexBindingPropertiesAttribute

Implementeringen

ICollection IEnumerable IList IBindingList IBindingListView ICancelAddNew ISupportInitialize ISupportInitializeNotification ITypedList ICurrencyManagerProvider

Voorbeelden

In het volgende codevoorbeeld ziet u een ListBox gebondenheid aan een BindingSource. De BindingSource is gebonden aan een BindingList<T> lijst met lettertypen.

using System;
using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;

namespace BindingSourceExamples;

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

    public Form1() => Load += Form1_Load;

    TextBox textBox1;
    Button button1;
    ListBox listBox1;

    BindingSource binding1;
    void Form1_Load(object sender, EventArgs e)
    {
        listBox1 = new ListBox();
        textBox1 = new TextBox();
        binding1 = [];
        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 += button1_Click;
        ClientSize = new Size(292, 266);
        Controls.Add(button1);
        Controls.Add(textBox1);
        Controls.Add(listBox1);

        MyFontList fonts = [];
        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";
    }

    void button1_Click(object sender, EventArgs e)
    {
        if (!binding1.SupportsSearching)
        {
            _ = 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 => 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.Equals((string)key, StringComparison.CurrentCultureIgnoreCase))
            {
                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

Opmerkingen

Het BindingSource onderdeel dient veel doeleinden. Ten eerste vereenvoudigt het bindingsbesturingselementen op een formulier met gegevens door valutabeheer, wijzigingsmeldingen en andere services tussen Windows Forms besturingselementen en gegevensbronnen te bieden. Dit wordt bereikt door het BindingSource onderdeel aan uw gegevensbron te koppelen met behulp van de DataSource eigenschap. Voor complexe bindingsscenario's kunt u de DataMember eigenschap desgewenst instellen op een specifieke kolom of lijst in de gegevensbron. Vervolgens koppelt u besturingselementen aan de BindingSource. Alle verdere interactie met de gegevens wordt bereikt met aanroepen naar het BindingSource onderdeel. Zie < >c1>Hoe to: Bind Windows Forms Controls to DBNull Database Values and Hoe to: Handle Errors and Exceptions that Occur with Databinding( (Fouten en uitzonderingen verwerken die optreden met Gegevensbinding) voor < voorbeelden van het vereenvoudigen van het bindingsproces. Navigatie en het bijwerken van de gegevensbron wordt uitgevoerd via methoden zoals MoveNext, MoveLasten Remove. Bewerkingen zoals sorteren en filteren worden verwerkt via de Sort en Filter eigenschappen. Zie BindingSource voor meer informatie over het gebruik van sorteren en filteren met de .

Daarnaast kan het BindingSource onderdeel fungeren als een sterk getypte gegevensbron. Normaal gesproken wordt het type onderliggende gegevensbron opgelost via een van de volgende mechanismen:

• Gebruik de Add methode om een item toe te voegen aan het BindingSource onderdeel.

• Stel de DataSource eigenschap in op een lijst, één object of type.

Beide mechanismen maken een sterk getypte lijst. Zie BindingSource voor meer informatie over het gebruik van de om een type te binden. U kunt de BindingSource besturingselementen ook koppelen aan een fabrieksobject. Zie How to: Bind a Windows Forms Control to a Factory Object voor meer informatie over hoe u dit doet.

BindingSource biedt leden toegang tot de onderliggende gegevens. Het huidige item kan worden opgehaald via de Current eigenschap en de hele lijst kan worden opgehaald via de List eigenschap. Bewerkingen worden ondersteund voor het huidige item en Current de RemoveCurrent, EndEditCancelEdit en Add methodenAddNew. Hoewel valutabeheer automatisch wordt verwerkt voor alle onderliggende gegevensbrontypen, bevat deze klasse een aantal gebeurtenissen, zoals CurrentItemChanged en DataSourceChanged, die aanpassing mogelijk maken.

Gegevensbronnen die zijn gebonden aan een BindingSource onderdeel, kunnen ook worden genavigeerd en beheerd met de BindingNavigator klasse, die een VCR-achtige gebruikersinterface (UI) biedt voor het navigeren door items in een lijst. Hoewel BindingNavigator deze kan worden gebonden aan elke gegevensbron, is het ontworpen om te integreren met een BindingSource onderdeel via de BindingNavigator.BindingSource eigenschap.

De standaardeigenschap voor de BindingSource klasse is DataSource. De standaard gebeurtenis is CurrentChanged.

Zie ook

• BindingSource
• BindingNavigator
• DataGridView
• CurrencyManager
• IList
• IBindingList
• IEditableObject
• BindingSource-onderdeel