BindingSource-Klasse

BindingSource Komponenten dienen verschiedenen Zwecken. Erstens, sie vereinfacht das Binden von Steuerelementen an die Daten in einem Formular durch bereitgestelltes Währungsmanagement, Änderungsbenachrichtigung und andere Dienste zwischen Windows Forms und Datenquellen bereitstellen. Dies wird erreicht, indem die BindingSource Komponente an die Datenquelle mithilfe der DataSource-Eigenschaften angebunden wird. Für komplexe Bindungen von Szenarien können Sie optional über die DataMember-Eigenschaft die Bindung auf eine bestimmte Spalte oder einer Liste in der Datenquelle festlegen. Anschließend binden Sie Steuerelemente an die BindingSource. Alle weiteren Interaktionen mit den Daten kann durch Aufrufen von hinzugefügten BindingSource Komponenten durchgeführt werden. Beispiele dazu, wie BindingSource den Bindungsprozess vereinfachen kann, finden Sie unter Gewusst wie: Binden von Windows Forms-Steuerelementen an DBNull-Datenbankwerte und Gewusst wie: Behandeln von Fehlern und Ausnahmen in Zusammenhang mit der Datenbindung. Navigation und Aktualisieren der Datenquelle wird von Methoden wie erreicht MoveNextund MoveLastund Remove. Vorgänge wie das Sortieren und Filtern von behandelt werden Sort und Filter-Eigenschaften. Weitere Informationen über die Verwendung der Sortierung und Filterung mit BindingSourcefinden Sie unter Gewusst wie: Sortieren und Filtern von ADO.NET-Daten mit der BindingSource-Komponente in Windows Forms.

Außerdem BindingSource Komponente kann als eine stark typisierte Datenquelle auftreten. In der Regel wird der Typ der zugrunde liegende Datenquelle über einen der folgenden Mechanismen korrigiert:

• Verwenden Sie Add-Methode zum Hinzufügen eines Elements BindingSource Komponente.

• Legen Sie fest DataSource-Eigenschaft in einer Liste zu einem einzelnen Objekt oder einen Typ.

Beide Verfahren erstellen eine stark typisierte Liste. Weitere Informationen zum Erstellen verwendet BindingSource Binden an einen Typ finden Sie unter Gewusst wie: Binden eines Windows Forms-Steuerelements an einen Typ. Sie können auch BindingSource Die Steuerelemente werden an ein Factoryobjekt binden. Weitere Informationen finden Sie unter Gewusst wie: Binden eines Windows Forms-Steuerelements an ein Factoryobjekt.

Hinweis

Da ein BindingSource behandelte einfachen und komplexen Datenquellen, Terminologie ist problematisch. Innerhalb dieser Klassen in der Ausdruck Liste bezieht sich auf eine Datensammlung in der gehosteten Datenquelle an. Element kennzeichnet ein einzelnes Element. Wenn die Funktionalität beschrieben wird, die mit komplexen Datenquellen, die entsprechenden Ausdrücke zugeordnet ist. Tabelle und Zeile dienen.

BindingSource stellt Member für den Zugriff auf die zugrunde liegenden Daten bereit. Das aktuelle Element kann über abgerufen werden Current-Eigenschaft und die gesamte Liste abgerufen werden können List-Eigenschaft. Bearbeitungsvorgänge werden auf das aktuelle Element durch unterstützt Current und RemoveCurrentund EndEditund CancelEdit und Add und AddNew-Methoden. Auch wenn Währungs Ansichtszustandsverwaltung automatisch für alle zugrunde liegenden Datenquellentypen behandelt wird, macht dieser Klasse mehrere Ereignisse, z. CurrentItemChanged und DataSourceChangedlassen, die Anpassung zu.

Datenquellen, die auf einem gebunden sind BindingSource Komponente kann auch navigiert und verwaltet werden BindingNavigator-Klasse, die eine Videorekorder ähnliche Benutzeroberfläche (UI) zum Navigieren von Elementen in einer Liste bereitstellt. Zwar BindingNavigator kann an jeder beliebigen Datenquelle gebunden sind, es wurde entworfen, um mit A zu integrieren BindingSource Komponente durch seinen BindingNavigator.BindingSource-Eigenschaft.

Die Standardeigenschaft BindingSource-Klasse DataSource. Das Standardereignis ist CurrentChanged.

Vorsicht

Viele der Member BindingSource-Klasse werden für die zugrunde liegende Liste durchlaufen, die von dargestellte List-Eigenschaft und ihr Vorgang einfach verweisen auf die zugrunde liegende Liste. Wenn also BindingSource wird mit einer benutzerdefinierten Implementierung von gebundenen IListDas genaue Verhalten unterscheidet sich vom Verhalten dieser Member in der Dokumentation zur Klassen beschrieben wird. Beispiel: RemoveAt-Methoden IList.RemoveAt. BindingSource Dokumentation beschreibt RemoveAt-Methode unter der Bedingung, dass RemoveAt-Methode zum Zugrund zugrunde liegenden IList einwandfrei implementiert wird.

Im folgenden Codebeispiel wird ein ListBox Begrenzung zu ein BindingSource. BindingSource wird auf einer Bindung BindingList<T> Das enthält eine Liste der Schriftart.

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 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen