BindingSource Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

BindingSource.cs

Formun veri kaynağını kapsüller.

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.ISupportInitialize, System.ComponentModel.ISupportInitializeNotification, System.ComponentModel.ITypedList, System.Windows.Forms.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, 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ğinde bir ListBox ile ilişkili gösterilmektedir BindingSource. BindingSource, yazı tiplerinin listesini içeren bir öğesine bağlıdırBindingList<T>.

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

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 denetimlerini öğ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 BindingSource basitleştirebileceğine 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 kesin olarak yazılan bir veri kaynağı olarak hareket edebilir. Genellikle temel alınan veri kaynağının türü aşağıdaki mekanizmalardan biri aracılığıyla düzeltilir:

• Bileşenine 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.

Uyarı

Hem BindingSource basit hem de karmaşık veri kaynaklarını işlediği için terminoloji sorunludur. Bu sınıf belgelerinde , liste terimi barındırılan veri kaynağı içindeki bir veri koleksiyonuna başvurur ve öğe tek bir öğeyi belirtir. Karmaşık veri kaynaklarıyla ilişkili işlevler tartışılırken, eşdeğer terimler tablosu ve satırı kullanılır.

BindingSource temel alınan verilere erişmek için üyeler sağlar. Geçerli öğe özelliği aracılığıyla Current alınabilir ve tüm liste özelliği aracılığıyla List alınabilir. Düzenleme işlemleri geçerli öğede Current ve RemoveCurrentaracılığıyla ve , CancelEditEndEditve AddAddNew yöntemleriyle 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 liste içindeki öğ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.

Dikkat

Sınıfın BindingSource üyelerinin çoğu, özelliğiyle List temsil edilen temel listede çalışır ve yalnızca işlemlerini temel alınan listeye başvurur. Bu nedenle, özel BindingSource uygulamasına IListbağlı olduğunda, bu üyelerin tam davranışı sınıf belgelerinde açıklanan davranıştan farklı olabilir. Örneğin, RemoveAt yöntemi öğesini çağırır IList.RemoveAt. BelgelerdeBindingSource, temel IList alınan RemoveAt yöntemin doğru uygulandığını anlayarak RemoveAt yöntemi açıklanmaktadır.

Oluşturucular

Name	Description
BindingSource()	Sınıfın BindingSource yeni bir örneğini varsayılan özellik değerlerine başlatır.
BindingSource(IContainer)	sınıfının yeni bir örneğini BindingSource başlatır ve öğesini belirtilen kapsayıcıya ekler BindingSource .
BindingSource(Object, String)	Belirtilen veri kaynağı ve veri üyesi ile sınıfının yeni bir örneğini BindingSource başlatır.

Özellikler

Name	Description
AllowEdit	Temel alınan listedeki öğelerin düzenlenip düzenlenemeyeceğini belirten bir değer alır.
AllowNew	Yöntemin AddNew() listeye öğe eklemek için kullanılıp kullanılamayacağını belirten bir değer alır veya ayarlar.
AllowRemove	Öğelerin temel alınan listeden kaldırılıp kaldırılamayacağını belirten bir değer alır.
Count	Geçerli Filter değeri dikkate alarak temel alınan listedeki öğelerin toplam sayısını alır.
CurrencyManager	Bu BindingSourceile ilişkilendirilmiş para birimi yöneticisini alır.
Current	Listedeki geçerli öğeyi alır.
DataMember	Bağlayıcının şu anda bağlandığı veri kaynağındaki belirli listeyi alır veya ayarlar.
DataSource	Bağlayıcının bağlandığını veri kaynağını alır veya ayarlar.
Filter	Hangi satırların görüntüleneceğini filtrelemek için kullanılan ifadeyi alır veya ayarlar.
IsBindingSuspended	Liste bağlamasının askıya alınıp alınmadığını belirten bir değer alır.
IsFixedSize	Temel alınan listenin sabit bir boyuta sahip olup olmadığını gösteren bir değer alır.
IsReadOnly	Temel alınan listenin salt okunur olup olmadığını belirten bir değer alır.
IsSorted	Temel alınan listedeki öğelerin sıralanıp sıralanmadığını gösteren bir değer alır.
IsSynchronized	Koleksiyona erişimin eşitlenip eşitlenmediğini belirten bir değer alır (iş parçacığı güvenli).
Item[Int32]	Belirtilen dizinde liste öğesini alır veya ayarlar.
List	Bağlayıcının bağlı olduğu listeyi alır.
Position	Temel alınan listedeki geçerli öğenin dizinini alır veya ayarlar.
RaiseListChangedEvents	Olayların tetiklenip tetiklenmemesi gerektiğini belirten ListChanged bir değer alır veya ayarlar.
Sort	Sıralama için kullanılan sütun adlarını ve veri kaynağındaki satırları görüntülemek için sıralama düzenini alır veya ayarlar.
SortDescriptions	Veri kaynağına uygulanan sıralama açıklamalarının koleksiyonunu alır.
SortDirection	Listedeki öğelerin sıralandığı yönü alır.
SortProperty	Listeyi sıralamak PropertyDescriptor için kullanılan öğesini alır.
SupportsAdvancedSorting	Veri kaynağının çok sütunlu sıralamayı destekleyip desteklemediğini belirten bir değer alır.
SupportsChangeNotification	Veri kaynağının değişiklik bildirimini destekleyip desteklemediğini belirten bir değer alır.
SupportsFiltering	Veri kaynağının filtrelemeyi destekleyip desteklemediğini belirten bir değer alır.
SupportsSearching	Veri kaynağının yöntemiyle Find(PropertyDescriptor, Object) aramayı destekleyip desteklemediğini belirten bir değer alır.
SupportsSorting	Veri kaynağının sıralamayı destekleyip desteklemediğini belirten bir değer alır.
SyncRoot	Temel alınan listeye erişimi eşitlemek için kullanılabilecek bir nesne alır.

Yöntemler

Name	Description
Add(Object)	Var olan bir öğeyi iç listeye ekler.
AddNew()	Temel alınan listeye yeni bir öğe ekler.
ApplySort(ListSortDescriptionCollection)	Veri kaynağını belirtilen sıralama açıklamalarıyla sıralar.
ApplySort(PropertyDescriptor, ListSortDirection)	Belirtilen özellik tanımlayıcısını ve sıralama yönünü kullanarak veri kaynağını sıralar.
CancelEdit()	Geçerli düzenleme işlemini iptal eder.
Clear()	Listedeki tüm öğeleri kaldırır.
Contains(Object)	Bir nesnenin listedeki bir öğe olup olmadığını belirler.
CopyTo(Array, Int32)	öğesinin List içeriğini belirtilen dizin değerinden başlayarak belirtilen diziye kopyalar.
Dispose(Boolean)	tarafından BindingSource kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
EndEdit()	Temel alınan veri kaynağına bekleyen değişiklikleri uygular.
Find(PropertyDescriptor, Object)	Verilen özellik tanımlayıcısı olan öğenin dizinini arar.
Find(String, Object)	Belirtilen özellik adı ve değeriyle listedeki öğenin dizinini döndürür.
GetEnumerator()	için Listbir numaralandırıcı alır.
GetItemProperties(PropertyDescriptor[])	Veri kaynağı liste türünün bağlanabilir özelliklerini temsil eden bir nesne dizisi PropertyDescriptor alır.
GetListName(PropertyDescriptor[])	Bağlama için veri sağlayan listenin adını alır.
GetRelatedCurrencyManager(String)	Belirtilen veri üyesi için ilgili para birimi yöneticisini alır.
IndexOf(Object)	Belirtilen nesneyi arar ve listenin tamamında ilk oluşumun dizinini döndürür.
Insert(Int32, Object)	Belirtilen dizindeki listeye bir öğe ekler.
MoveFirst()	Listedeki ilk öğeye gider.
MoveLast()	Listedeki son öğeye gider.
MoveNext()	Listede bir sonraki öğeye geçer.
MovePrevious()	Listedeki bir önceki öğeye gider.
OnAddingNew(AddingNewEventArgs)	Olayı tetikler AddingNew .
OnBindingComplete(BindingCompleteEventArgs)	Olayı tetikler BindingComplete .
OnCurrentChanged(EventArgs)	Olayı tetikler CurrentChanged .
OnCurrentItemChanged(EventArgs)	Olayı tetikler CurrentItemChanged .
OnDataError(BindingManagerDataErrorEventArgs)	Olayı tetikler DataError .
OnDataMemberChanged(EventArgs)	Olayı tetikler DataMemberChanged .
OnDataSourceChanged(EventArgs)	Olayı tetikler DataSourceChanged .
OnListChanged(ListChangedEventArgs)	Olayı tetikler ListChanged .
OnPositionChanged(EventArgs)	Olayı tetikler PositionChanged .
Remove(Object)	Belirtilen öğeyi listeden kaldırır.
RemoveAt(Int32)	Listede belirtilen dizindeki öğeyi kaldırır.
RemoveCurrent()	Geçerli öğeyi listeden kaldırır.
RemoveFilter()	ile ilişkili filtreyi BindingSourcekaldırır.
RemoveSort()	ile ilişkili sıralamayı BindingSourcekaldırır.
ResetAllowNew()	Özelliği yeniden başlatıyor AllowNew .
ResetBindings(Boolean)	listedeki tüm öğeleri yeniden okumak ve görüntülenen değerlerini yenilemek için BindingSource öğesine bağlı bir denetimin neden olur.
ResetCurrentItem()	öğesine bağlı bir denetimin BindingSource seçili durumdaki öğeyi yeniden okumasına ve görüntülenen değerini yenilemesine neden olur.
ResetItem(Int32)	öğesine bağlı bir denetimin BindingSource belirtilen dizinde öğeyi yeniden okumasına ve görüntülenen değerini yenilemesine neden olur.
ResumeBinding()	Veri bağlamayı sürdürür.
SuspendBinding()	Değişikliklerin ilişkili veri kaynağını güncelleştirmesini önlemek için veri bağlamayı askıya alır.

Ekinlikler

Name	Description
AddingNew	Bir öğe temel alınan listeye eklenmeden önce gerçekleşir.
BindingComplete	Tüm istemciler bu BindingSourceöğesine bağlı olduğunda gerçekleşir.
CurrentChanged	Şu anda bağlı olan öğe değiştiğinde gerçekleşir.
CurrentItemChanged	Özelliğin özellik değeri değiştiğinde Current gerçekleşir.
DataError	Para birimiyle ilgili özel durum tarafından BindingSourcesessizce işlendiğinde gerçekleşir.
DataMemberChanged	DataMember özelliğinin değeri değiştiğinde meydana gelir.
DataSourceChanged	DataSource özelliğinin değeri değiştiğinde meydana gelir.
ListChanged	Temel alınan liste değiştiğinde veya listedeki bir öğe değiştiğinde gerçekleşir.
PositionChanged	Özelliğin değeri Position değiştirildikten sonra gerçekleşir.

Belirtik Arabirim Kullanımları

Name	Description
IBindingList.AddIndex(PropertyDescriptor)	öğesini PropertyDescriptor arama için kullanılan dizinlere ekler.
IBindingList.RemoveIndex(PropertyDescriptor)	PropertyDescriptor arama için kullanılan dizinlerden öğesini kaldırır.
ICancelAddNew.CancelNew(Int32)	Koleksiyondan bekleyen yeni bir öğeyi atar.
ICancelAddNew.EndNew(Int32)	Bekleyen yeni bir öğeyi koleksiyona işler.
ISupportInitialize.BeginInit()	Başlatmanın BindingSource başlatıldığını gösterir.
ISupportInitialize.EndInit()	Başlatma işleminin BindingSource tamamlandığını gösterir.
ISupportInitializeNotification.Initialized	BindingSource başlatıldığında gerçekleşir.
ISupportInitializeNotification.IsInitialized	öğesinin başlatılıp başlatılmadığını BindingSource belirten bir değer alır.

Ayrıca bkz.

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