BindingSource Sınıf

Tanım

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

Devralma

Object

MarshalByRefObject

Component

BindingSource

Öznitelikler

ComplexBindingPropertiesAttribute

Uygulamalar

ICollection IEnumerable IList IBindingList IBindingListView ICancelAddNew ISupportInitialize ISupportInitializeNotification ITypedList ICurrencyManagerProvider

Örnekler

Aşağıdaki kod örneği bir ListBox ile ilişkili olduğunu BindingSourcegösterir. BindingSource, yazı tiplerinin listesini içeren bir öğesine bağlıdırBindingList<T>.

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

Açıklamalar

Bileşen BindingSource birçok amaca hizmet eder. İlk olarak, Windows Forms denetimleri ve veri kaynakları arasında para birimi yönetimi, değişiklik bildirimi ve diğer hizmetler sağlayarak formdaki denetimleri verilere bağlamayı basitleştirir. Bu, özelliğini kullanarak DataSource bileşeni veri kaynağınıza ekleyerek BindingSource gerçekleştirilir. Karmaşık bağlama senaryoları için isteğe bağlı olarak özelliğini veri kaynağındaki DataMember belirli bir sütuna veya listeye ayarlayabilirsiniz. Ardından denetimleri öğesine BindingSourcebağlarsınız. Verilerle daha fazla etkileşim, bileşene BindingSource yapılan çağrılarla gerçekleştirilir. bağlama işlemini nasıl basitleştirebileceğine BindingSource ilişkin örnekler için bkz. How to: Bind Windows Forms Controls to DBNull Database Values and How to: Handle Errors and Exceptions that Occur with Databinding. Veri kaynağının gezintisi ve güncelleştirilmesi, , MoveLastve Removegibi MoveNextyöntemlerle gerçekleştirilir. Sıralama ve filtreleme gibi işlemler ve Filter özellikleri aracılığıyla Sort işlenir. ile BindingSourcesıralama ve filtreleme kullanma hakkında daha fazla bilgi için bkz. How to: Sort and Filter ADO.NET Data with the Windows Forms BindingSource Component.

Buna ek olarak, BindingSource bileşen türü kesin olarak belirlenmiş bir veri kaynağı olarak hareket edebilir. Genellikle temel alınan veri kaynağının türü aşağıdaki mekanizmalardan biriyle düzeltilir:

• Bileşene Add bir öğe eklemek için BindingSource yöntemini kullanın.

• DataSource özelliğini bir liste, tek nesne veya tür olarak ayarlayın.

Bu mekanizmaların her ikisi de kesin olarak belirlenmiş bir liste oluşturur. bir türe bağlamak için kullanma BindingSource hakkında daha fazla bilgi için bkz. Nasıl yapılır: Windows Forms Denetimini Türe Bağlama. Denetimlerinizi bir fabrika nesnesine bağlamak için de kullanabilirsiniz BindingSource . Bunun nasıl yapacağı hakkında daha fazla bilgi için bkz. Nasıl yapılır: Windows Forms Denetimini Fabrika Nesnesine Bağlama.

BindingSource , temel alınan verilere erişmek için üyeler sağlar. Geçerli öğe özelliği aracılığıyla Current alınabilir ve listenin tamamı özelliği aracılığıyla List alınabilir. Düzenleme işlemleri geçerli öğe üzerinde ve RemoveCurrent, , CancelEditEndEditve AddNewAdd yöntemleri aracılığıyla Current desteklenir. Para birimi yönetimi tüm temel alınan veri kaynağı türleri için otomatik olarak işlense de, bu sınıf özelleştirmeye olanak sağlayan ve DataSourceChangedgibi CurrentItemChanged bir dizi olayı kullanıma sunar.

Bir BindingSource bileşene bağlı veri kaynakları, bir listedeki öğelerde gezinmek için VCR benzeri bir kullanıcı arabirimi (UI) sağlayan sınıfıyla BindingNavigator da gezinilebilir ve yönetilebilir. BindingNavigator Herhangi bir veri kaynağına bağlı olsa da, özelliği aracılığıyla BindingNavigator.BindingSource bir BindingSource bileşenle tümleştirilecek şekilde tasarlanmıştır.

sınıfının varsayılan özelliğidir BindingSourceDataSource. Varsayılan olay: CurrentChanged.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• BindingSource
• BindingNavigator
• DataGridView
• CurrencyManager
• IList
• IBindingList
• IEditableObject
• BindingSource Bileşeni