BindingSource Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

BindingSource.cs

Beágyazza egy űrlap adatforrását.

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

Öröklődés

Object

MarshalByRefObject

Component

BindingSource

Attribútumok

ComplexBindingPropertiesAttribute

Megvalósítás

ICollection IEnumerable IList IBindingList IBindingListView ICancelAddNew ISupportInitialize ISupportInitializeNotification ITypedList ICurrencyManagerProvider

Példák

Az alábbi példakód egy adotthoz ListBoxkötött kódot mutat beBindingSource. A BindingSource betűkészlet olyanhoz BindingList<T> van kötve, amely a betűtípusok listáját tartalmazza.

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

Megjegyzések

Az BindingSource összetevő számos célt szolgál. Először is leegyszerűsíti az űrlapok adathoz kötési vezérlőit azáltal, hogy pénznemkezelést, változásértesítést és egyéb szolgáltatásokat biztosít Windows Forms vezérlők és adatforrások között. Ez úgy érhető el, hogy az összetevőt az BindingSource adatforráshoz csatolja a DataSource tulajdonság használatával. Összetett kötési forgatókönyvek esetén igény szerint beállíthatja a DataMember tulajdonságot egy adott oszlopra vagy listára az adatforrásban. Ezután a vezérlőket a BindingSource. Az adatokkal való további interakció az összetevő hívásaival BindingSource történik. Példák a BindingSource kötési folyamatának egyszerűsítésére: Hozzáadás a következőhöz: Windows Forms vezérlők kötése a DBNull-adatbázis értékeihez és A következőhöz: Adatkötéssel előforduló hibák és kivételek kezelése. Az adatforrás navigációja és frissítése olyan módszerekkel történik, mint MoveNextaz , MoveLastés Remove. Az olyan műveleteket, mint a rendezés és a szűrés, a tulajdonságokon keresztül kezelik SortFilter . A BindingSource használatával kapcsolatos további információkért lásd: Az ADO rendezése és szűrése.NET Adatok a Windows Forms BindingSource összetevővel.

Emellett az BindingSource összetevő erősen gépelt adatforrásként is működhet. Az alapul szolgáló adatforrás típusa általában az alábbi mechanizmusok egyikével van javítva:

• Add A metódus használatával elemet adhat hozzá az BindingSource összetevőhöz.

• Állítsa be a DataSource tulajdonságot listára, egyetlen objektumra vagy típusra.

Mindkét mechanizmus egy erősen gépelt listát hoz létre. A BindingSource típushoz való kötéséről további információt a Hogyan is: Windows Forms vezérlőelem kötése típushoz. A vezérlőket egy gyári objektumhoz is BindingSource kötheti. Ennek módjáról további információt a Hogyan is: Windows Forms vezérlőelem kötése gyári objektumhoz.

Note

Mivel egy BindingSource egyszerű és összetett adatforrást is kezel, a terminológia problémás. Ebben az osztálydokumentációban a kifejezéslista az üzemeltetett adatforráson belüli adatgyűjtésre hivatkozik, az elem pedig egyetlen elemet jelöl. Az összetett adatforrásokhoz társított funkciók megvitatásakor a tábla és a sor egyenértékű kifejezéseket használja.

BindingSource hozzáférést biztosít a tagoknak az alapul szolgáló adatokhoz. Az aktuális elem lekérhető a Current tulajdonságon keresztül, és a teljes lista lekérhető a List tulajdonságon keresztül. A szerkesztési műveletek az aktuális elemen, valamint a Current, RemoveCurrentEndEdit és CancelEditAdd metódusokon keresztül AddNew támogatottak. Bár a pénznemkezelés automatikusan történik az összes mögöttes adatforrástípus esetében, ez az osztály számos olyan eseményt tesz elérhetővé, például CurrentItemChanged és DataSourceChanged, amelyek lehetővé teszik a testreszabást.

Az összetevőhöz BindingSource kötött adatforrások az osztálysal BindingNavigator is navigálhatók és kezelhetők, amely egy VCR-szerű felhasználói felületet (UI) biztosít a lista elemeinek navigálásához. Bár BindingNavigator bármilyen adatforráshoz köthető, úgy lett kialakítva, hogy a tulajdonságán BindingSource keresztül integrálható legyen egy BindingNavigator.BindingSource összetevővel.

Az osztály alapértelmezett tulajdonsága az BindingSourceDataSource. Az alapértelmezett esemény a következő CurrentChanged: .

Figyelmeztetés

Az osztály számos tagja BindingSource a tulajdonság által List képviselt mögöttes listán dolgozik, és egyszerűen hivatkozik a műveletére az alapul szolgáló listára. Ezért, ha az BindingSource egyéni implementációhoz IListvan kötve, ezeknek a tagoknak a pontos viselkedése eltérhet az osztálydokumentációban leírt viselkedéstől. A metódus például meghívja a metódust RemoveAtIList.RemoveAt. A BindingSource dokumentáció azzal a megértéssel írja le a RemoveAt metódust, hogy az RemoveAt alapul szolgáló IList módszer helyesen van implementálva.

Konstruktorok

Name	Description
BindingSource()	Inicializálja az BindingSource osztály új példányát az alapértelmezett tulajdonságértékekre.
BindingSource(IContainer)	Inicializálja az BindingSource osztály új példányát, és hozzáadja a BindingSource megadott tárolóhoz.
BindingSource(Object, String)	Inicializálja az osztály új példányát BindingSource a megadott adatforrással és adattaggal.

Tulajdonságok

Name	Description
AllowEdit	Beolvas egy értéket, amely jelzi, hogy a mögöttes lista elemei szerkeszthetők-e.
AllowNew	Lekéri vagy beállít egy értéket, amely jelzi, hogy a AddNew() metódus használható-e elemek hozzáadására a listához.
AllowRemove	Beolvas egy értéket, amely jelzi, hogy az elemek eltávolíthatók-e az alapul szolgáló listából.
Count	Lekéri az alapul szolgáló lista elemeinek teljes számát, figyelembe véve az aktuális Filter értéket.
CurrencyManager	Lekéri a hozzá társított pénznemkezelőt BindingSource.
Current	Lekéri az aktuális elemet a listában.
DataMember	Lekéri vagy beállítja azt az adatforrást, amelyhez az összekötő jelenleg kapcsolódik.
DataSource	Lekéri vagy beállítja azt az adatforrást, amelyhez az összekötő kapcsolódik.
Filter	Lekéri vagy beállítja a megtekintett sorok szűréséhez használt kifejezést.
IsBindingSuspended	Beolvas egy értéket, amely jelzi, hogy a listakötés fel van-e függesztve.
IsFixedSize	Beolvas egy értéket, amely jelzi, hogy az alapul szolgáló lista rögzített méretű-e.
IsReadOnly	Beolvas egy értéket, amely jelzi, hogy az alapul szolgáló lista írásvédett-e.
IsSorted	Beolvas egy értéket, amely jelzi, hogy a mögöttes lista elemei rendezve vannak-e.
IsSynchronized	Beolvas egy értéket, amely jelzi, hogy a gyűjteményhez való hozzáférés szinkronizálva van-e (a szál biztonságos).
Item[Int32]	Lekéri vagy beállítja a listaelemet a megadott indexen.
List	Lekéri azt a listát, amelyhez az összekötő hozzá van kötve.
Position	Lekéri vagy beállítja az aktuális elem indexét az alapul szolgáló listában.
RaiseListChangedEvents	Lekéri vagy beállít egy értéket, amely jelzi, hogy az eseményeket emelni kell-e ListChanged .
Sort	Lekéri vagy beállítja a rendezéshez használt oszlopneveket, valamint az adatforrás sorainak megtekintéséhez szükséges rendezési sorrendet.
SortDescriptions	Lekéri az adatforrásra alkalmazott rendezési leírások gyűjteményét.
SortDirection	Lekérdezi a lista elemeinek rendezésének irányát.
SortProperty	Lekéri a PropertyDescriptor lista rendezéséhez használt elemet.
SupportsAdvancedSorting	Beolvas egy értéket, amely jelzi, hogy az adatforrás támogatja-e a többoszlopos rendezést.
SupportsChangeNotification	Beolvas egy értéket, amely jelzi, hogy az adatforrás támogatja-e a változásértesítést.
SupportsFiltering	Beolvas egy értéket, amely jelzi, hogy az adatforrás támogatja-e a szűrést.
SupportsSearching	Beolvas egy értéket, amely jelzi, hogy az adatforrás támogatja-e a metódussal végzett Find(PropertyDescriptor, Object) keresést.
SupportsSorting	Beolvas egy értéket, amely jelzi, hogy az adatforrás támogatja-e a rendezést.
SyncRoot	Lekéri a mögöttes listához való hozzáférés szinkronizálására használható objektumot.

Metódusok

Name	Description
Add(Object)	Hozzáad egy meglévő elemet a belső listához.
AddNew()	Új elemet ad hozzá az alapul szolgáló listához.
ApplySort(ListSortDescriptionCollection)	Az adatforrás rendezése a megadott rendezési leírásokkal.
ApplySort(PropertyDescriptor, ListSortDirection)	Az adatforrás rendezése a megadott tulajdonságleíró és rendezési irány használatával.
CancelEdit()	Megszakítja az aktuális szerkesztési műveletet.
Clear()	Eltávolítja az összes elemet a listából.
Contains(Object)	Meghatározza, hogy egy objektum szerepel-e a listában.
CopyTo(Array, Int32)	Másolja a List megadott tömb tartalmát a megadott indexértéktől kezdve.
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által BindingSource használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat.
EndEdit()	Függőben lévő módosításokat alkalmaz az alapul szolgáló adatforrásra.
Find(PropertyDescriptor, Object)	Megkeresi az adott tulajdonságleírót tartalmazó elem indexét.
Find(String, Object)	A listában szereplő elem indexét adja vissza a megadott tulajdonságnévvel és értékkel.
GetEnumerator()	Beolvas egy enumerátort a List.
GetItemProperties(PropertyDescriptor[])	Lekéri az adatforráslista típusának kötésre alkalmas tulajdonságait képviselő objektumtömböt PropertyDescriptor .
GetListName(PropertyDescriptor[])	Lekéri a kötés adatait tartalmazó lista nevét.
GetRelatedCurrencyManager(String)	Lekéri a kapcsolódó pénznemkezelőt a megadott adattaghoz.
IndexOf(Object)	Megkeresi a megadott objektumot, és visszaadja az első előfordulás indexét a teljes listában.
Insert(Int32, Object)	Beszúr egy elemet a megadott index listájába.
MoveFirst()	Ugrás a lista első elemére.
MoveLast()	Ugrás a lista utolsó elemére.
MoveNext()	Ugrás a lista következő elemére.
MovePrevious()	Ugrás a lista előző elemére.
OnAddingNew(AddingNewEventArgs)	Az eseményt emeli AddingNew ki.
OnBindingComplete(BindingCompleteEventArgs)	Az eseményt emeli BindingComplete ki.
OnCurrentChanged(EventArgs)	Az eseményt emeli CurrentChanged ki.
OnCurrentItemChanged(EventArgs)	Az eseményt emeli CurrentItemChanged ki.
OnDataError(BindingManagerDataErrorEventArgs)	Az eseményt emeli DataError ki.
OnDataMemberChanged(EventArgs)	Az eseményt emeli DataMemberChanged ki.
OnDataSourceChanged(EventArgs)	Az eseményt emeli DataSourceChanged ki.
OnListChanged(ListChangedEventArgs)	Az eseményt emeli ListChanged ki.
OnPositionChanged(EventArgs)	Az eseményt emeli PositionChanged ki.
Remove(Object)	Eltávolítja a megadott elemet a listából.
RemoveAt(Int32)	Eltávolítja az elemet a listában megadott indexből.
RemoveCurrent()	Eltávolítja az aktuális elemet a listából.
RemoveFilter()	Eltávolítja a hozzá társított szűrőt BindingSource.
RemoveSort()	Eltávolítja a .-hoz BindingSourcetársított rendezést.
ResetAllowNew()	Újraincializálja a tulajdonságot AllowNew .
ResetBindings(Boolean)	A lista összes elemének újraolvasásához BindingSource és a megjelenített értékek frissítéséhez a vezérlőhöz kötött vezérlőelemet okoz.
ResetCurrentItem()	Az aktuálisan kijelölt elem újraolvasásához BindingSource és a megjelenített érték frissítéséhez a vezérlőelemhez kötött vezérlőelemet okoz.
ResetItem(Int32)	Az elemnek a BindingSource megadott indexben való újraolvasásához és a megjelenített érték frissítéséhez kapcsolódó vezérlőt okoz.
ResumeBinding()	Folytatja az adatkötést.
SuspendBinding()	Felfüggeszti az adatkötést, hogy megakadályozza a kötött adatforrás frissítését.

esemény

Name	Description
AddingNew	Mielőtt hozzáad egy elemet az alapul szolgáló listához.
BindingComplete	Akkor fordul elő, ha az összes ügyfél ehhez BindingSourcevan kötve.
CurrentChanged	Ez akkor fordul elő, ha a jelenleg kötött elem megváltozik.
CurrentItemChanged	Akkor fordul elő, ha a Current tulajdonság tulajdonságértéke megváltozott.
DataError	Akkor fordul elő, ha a pénznemhez kapcsolódó kivételt a rendszer csendesen kezeli.BindingSource
DataMemberChanged	Akkor fordul elő, ha a DataMember tulajdonság értéke megváltozott.
DataSourceChanged	Akkor fordul elő, ha a DataSource tulajdonság értéke megváltozott.
ListChanged	Akkor fordul elő, ha az alapul szolgáló lista vagy a lista egy eleme megváltozik.
PositionChanged	A tulajdonság értékének Position módosítása után következik be.

Explicit interfész-implementációk

Name	Description
IBindingList.AddIndex(PropertyDescriptor)	Hozzáadja a PropertyDescriptor kereséshez használt indexekhez.
IBindingList.RemoveIndex(PropertyDescriptor)	Eltávolítja a PropertyDescriptor kereséshez használt indexekből.
ICancelAddNew.CancelNew(Int32)	Elvet egy függőben lévő új elemet a gyűjteményből.
ICancelAddNew.EndNew(Int32)	Függőben lévő új elemet véglegesíti a gyűjteményben.
ISupportInitialize.BeginInit()	Azt jelzi, hogy az BindingSource inicializálás elkezdődött.
ISupportInitialize.EndInit()	Azt jelzi, hogy az BindingSource inicializálás befejeződött.
ISupportInitializeNotification.Initialized	Az inicializáláskor BindingSource következik be.
ISupportInitializeNotification.IsInitialized	Beolvas egy értéket, amely jelzi, hogy az BindingSource inicializálva van-e.

Lásd még

• BindingSource
• BindingNavigator
• DataGridView
• CurrencyManager
• IList
• IBindingList
• IEditableObject
• BindingSource-összetevő