BindingSource Klasse

Definition

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

Vererbung

Object

MarshalByRefObject

Component

BindingSource

Attribute

ComplexBindingPropertiesAttribute

Implementiert

ICollection IEnumerable IList IBindingList IBindingListView ICancelAddNew ISupportInitialize ISupportInitializeNotification ITypedList ICurrencyManagerProvider

Beispiele

Im folgenden Codebeispiel wird eine ListBox Bindung an ein BindingSourceveranschaulicht. Der BindingSource ist an eine BindingList<T> gebunden, die eine Liste von Schriftarten enthält.

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

Hinweise

Die BindingSource Komponente dient vielen Zwecken. Erstens vereinfacht es die Bindung von Steuerelementen für ein Formular an Daten, indem währungsverwaltung, Änderungsbenachrichtigungen und andere Dienste zwischen Windows Forms-Steuerelementen und Datenquellen bereitgestellt werden. Dies wird erreicht, indem Sie die BindingSource Komponente mithilfe der -Eigenschaft an Ihre DataSource Datenquelle anfügen. Bei komplexen Bindungsszenarien können Sie die DataMember Eigenschaft optional auf eine bestimmte Spalte oder Liste in der Datenquelle festlegen. Anschließend binden Sie Steuerelemente an .BindingSource Die weitere Interaktion mit den Daten erfolgt durch Aufrufe der BindingSource Komponente. Beispiele für BindingSource die Vereinfachung des Bindungsprozesses finden Sie unter How to: Bind Windows Forms Controls to DBNull Database Values und How to: Behandeln von Fehlern und Ausnahmen, die bei der Datenbindung auftreten. Die Navigation und Aktualisierung der Datenquelle erfolgt über Methoden wie MoveNext, MoveLastund Remove. Vorgänge wie Sortieren und Filtern werden über die Sort Eigenschaften und Filter verarbeitet. Weitere Informationen zur Verwendung der Sortierung und Filterung mit dem BindingSourcefinden Sie unter Vorgehensweise: Sortieren und Filtern ADO.NET Daten mit der Windows Forms BindingSource-Komponente.

Darüber hinaus kann die BindingSource Komponente als stark typisierte Datenquelle fungieren. In der Regel wird der Typ der zugrunde liegenden Datenquelle durch einen der folgenden Mechanismen behoben:

• Verwenden Sie die Add -Methode, um der BindingSource Komponente ein Element hinzuzufügen.

• Legen Sie die DataSource Eigenschaft auf eine Liste, ein einzelnes Objekt oder einen Typ fest.

Beide Mechanismen erstellen eine stark typisierte Liste. Weitere Informationen zur Verwendung von BindingSource zum Binden an einen Typ finden Sie unter Vorgehensweise: Binden eines Windows Forms-Steuerelements an einen Typ. Sie können auch die BindingSource verwenden, um Ihre Steuerelemente an ein Factoryobjekt zu binden. Weitere Informationen dazu finden Sie unter Vorgehensweise: Binden eines Windows Forms-Steuerelements an ein Factory-Objekt.

BindingSource stellt Member für den Zugriff auf die zugrunde liegenden Daten bereit. Das aktuelle Element kann über die Current -Eigenschaft abgerufen werden, und die gesamte Liste kann über die List -Eigenschaft abgerufen werden. Bearbeitungsvorgänge werden für das aktuelle Element durch Current und die RemoveCurrentMethoden , EndEditund CancelEdit und AddNewAdd unterstützt. Obwohl die Währungsverwaltung für alle zugrunde liegenden Datenquellentypen automatisch behandelt wird, macht diese Klasse eine Reihe von Ereignissen verfügbar, z CurrentItemChanged . B. und DataSourceChanged, die eine Anpassung ermöglichen.

Datenquellen, die an eine BindingSource Komponente gebunden sind, können auch mit der BindingNavigator -Klasse navigiert und verwaltet werden, die eine VCR-ähnliche Benutzeroberfläche (UI) zum Navigieren durch Elemente in einer Liste bereitstellt. Obwohl BindingNavigator sie an eine beliebige Datenquelle gebunden werden kann, wurde sie für die Integration in eine BindingSource Komponente über ihre BindingNavigator.BindingSource Eigenschaft konzipiert.

Die Standardeigenschaft für die BindingSource -Klasse ist DataSource. Das Standardereignis ist CurrentChanged.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für:

Weitere Informationen

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