BindingSource BindingSource BindingSource BindingSource Class

定義

封裝表單的資料來源。Encapsulates the data source for a form.

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
[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
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
Public Class BindingSource
Inherits Component
Implements IBindingListView, ICancelAddNew, ICurrencyManagerProvider, IList, ISupportInitializeNotification, ITypedList
繼承
屬性
實作

範例

下列程式碼範例示範ListBox繫結至BindingSourceThe following code example demonstrates a ListBox bound to a BindingSource. BindingSource繫結至BindingList<T>包含字型清單。The BindingSource is bound to a BindingList<T> that contains a list of fonts.

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
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

備註

BindingSource元件有許多用途。The BindingSource component serves many purposes. 首先,它可簡化將控制項繫結至資料的表單上提供貨幣管理、 變更通知和 Windows Form 控制項與資料來源之間的其他服務。First, it simplifies binding controls on a form to data by providing currency management, change notification, and other services between Windows Forms controls and data sources. 這可以藉由附加BindingSource元件至您的資料來源使用DataSource屬性。This is accomplished by attaching the BindingSource component to your data source using the DataSource property. 對於複雜的繫結案例您可以選擇性地設定DataMember特定的資料行或清單資料來源中的屬性。For complex binding scenarios you can optionally set the DataMember property to a specific column or list in the data source. 您接著將控制項繫結至BindingSourceYou then bind controls to the BindingSource. 與資料的所有進一步互動可在完成呼叫BindingSource元件。All further interaction with the data is accomplished with calls to the BindingSource component. 如需如何的範例BindingSource可以簡化繫結程序,請參閱How to:Windows Forms 控制項繫結至 DBNull 資料庫值How to:處理錯誤和資料繫結時所發生例外狀況For examples on how the BindingSource can simplify the binding process, see How to: Bind Windows Forms Controls to DBNull Database Values and How to: Handle Errors and Exceptions that Occur with Databinding. 瀏覽和資料來源的更新透過完成方法這類MoveNextMoveLast,和RemoveNavigation and updating of the data source is accomplished through methods such as MoveNext, MoveLast, and Remove. 透過處理作業,例如排序和篩選SortFilter屬性。Operations such as sorting and filtering are handled through the Sort and Filter properties. 如需有關使用排序和篩選BindingSource,請參閱How to:排序和篩選 ADO.NET 資料使用 Windows Forms BindingSource 元件For more information on using sorting and filtering with the BindingSource, see How to: Sort and Filter ADO.NET Data with the Windows Forms BindingSource Component.

颾魤 ㄛBindingSource元件可以做為強類型的資料來源。In addition, the BindingSource component can act as a strongly typed data source. 通常被固定的基礎資料來源類型,透過下列機制的其中一個:Typically the type of the underlying data source is fixed through one of the following mechanisms:

這兩種機制建立強型別清單。Both of these mechanisms create a strongly-typed list. 如需有關如何使用BindingSource若要繫結至型別,請參閱How to:將 Windows Forms 控制項繫結至型別For more information on how to use the BindingSource to bind to a type, see How to: Bind a Windows Forms Control to a Type. 您也可以使用BindingSource將您的控制項繫結至 factory 物件。You can also use the BindingSource to bind your controls to a factory object. 如需有關如何執行這項操作的詳細資訊,請參閱How to:將 Windows Forms 控制項繫結至 Factory 物件For more information on how to do this, see How to: Bind a Windows Forms Control to a Factory Object.

注意

因為BindingSource處理這兩個簡單和複雜的資料來源術語會造成問題。Because a BindingSource handles both simple and complex data sources, terminology is problematic. 在此類別文件中,詞彙清單是指資料集合,在裝載的資料來源中,和項目代表單一項目。Within this class documentation, the term list refers to a data collection within the hosted data source, and item denotes a single element. 當討論功能相關聯複雜的資料來源,對等的詞彙表格資料列使用。When discussing functionality associated with complex data sources, the equivalent terms table and row are used.

BindingSource 提供存取基礎資料的成員。BindingSource provides members for accessing the underlying data. 可以透過擷取目前的項目Current屬性,然後將整個清單可以透過擷取List屬性。The current item can be retrieved through the Current property, and the entire list can be retrieved through the List property. 目前的項目,透過支援的編輯作業CurrentRemoveCurrentEndEditCancelEditAddAddNew方法。Editing operations are supported on the current item through Current and the RemoveCurrent, EndEdit, CancelEdit and Add and AddNew methods. 雖然貨幣管理會自動處理所有基礎資料來源類型,這個類別公開 (expose) 有多個事件,例如CurrentItemChangedDataSourceChanged,可讓自訂。Although currency management is handled automatically for all underlying data source types, this class exposes a number of events, such as CurrentItemChanged and DataSourceChanged, that allow for customization.

繫結至資料來源BindingSource元件也可瀏覽和管理與BindingNavigator類別,可提供類似 VCR 的使用者介面 (UI) 用於巡覽清單項目。Data sources that are bound to a BindingSource component can also be navigated and managed with the BindingNavigator class, which provides a VCR-like user interface (UI) for navigating items within a list. 雖然BindingNavigator可以繫結至任何資料來源,其設計用意與整合BindingSource元件透過其BindingNavigator.BindingSource屬性。Although BindingNavigator can be bound to any data source, it was designed to integrate with a BindingSource component through its BindingNavigator.BindingSource property.

預設屬性BindingSource類別是DataSourceThe default property for the BindingSource class is DataSource. 預設事件是CurrentChangedThe default event is CurrentChanged.

警告

許多的成員清單BindingSource類別所表示的基礎清單操作List屬性,而且只參考其作業的基礎清單。Many of the members of the BindingSource class operate on the underlying list represented by the List property and simply refer their operation to the underlying list. 因此,當BindingSource繫結至的自訂實作IList,這些成員的確切行為可能不同於類別文件中所述的行為。Therefore, when the BindingSource is bound to a custom implementation of IList, the exact behavior of these members may differ from the behavior described in the class documentation. 例如,RemoveAt方法呼叫IList.RemoveAtFor example, the RemoveAt method calls IList.RemoveAt. BindingSource文件說明RemoveAt了解的方法可RemoveAt為基礎的方法IList已正確地實作。The BindingSource documentation describes the RemoveAt method with the understanding that the RemoveAt method for the underlying IList is correctly implemented.

建構函式

BindingSource() BindingSource() BindingSource() BindingSource()

初始化的新執行個體BindingSource類別的預設屬性值。Initializes a new instance of the BindingSource class to the default property values.

BindingSource(IContainer) BindingSource(IContainer) BindingSource(IContainer) BindingSource(IContainer)

初始化的新執行個體BindingSource類別,以及新增BindingSource至指定的容器。Initializes a new instance of the BindingSource class and adds the BindingSource to the specified container.

BindingSource(Object, String) BindingSource(Object, String) BindingSource(Object, String) BindingSource(Object, String)

初始化的新執行個體BindingSource與指定的資料來源和資料成員的類別。Initializes a new instance of the BindingSource class with the specified data source and data member.

屬性

AllowEdit AllowEdit AllowEdit AllowEdit

取得值,指出基礎清單中的項目是否可以編輯。Gets a value indicating whether items in the underlying list can be edited.

AllowNew AllowNew AllowNew AllowNew

取得或設定值,指出是否AddNew()方法可用來將項目新增至清單。Gets or sets a value indicating whether the AddNew() method can be used to add items to the list.

AllowRemove AllowRemove AllowRemove AllowRemove

取得值,指出是否可以從基礎清單中移除項目。Gets a value indicating whether items can be removed from the underlying list.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

取得值,指出元件是否能引發事件。Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

取得包含 IContainerComponentGets the IContainer that contains the Component.

(Inherited from Component)
Count Count Count Count

取得基礎清單中,目前的項目總數Filter值納入考慮。Gets the total number of items in the underlying list, taking the current Filter value into consideration.

CurrencyManager CurrencyManager CurrencyManager CurrencyManager

取得與這個關聯的 currency 管理員BindingSourceGets the currency manager associated with this BindingSource.

Current Current Current Current

取得清單中的目前項目。Gets the current item in the list.

DataMember DataMember DataMember DataMember

取得或設定此連接器目前繫結至的資料來源中的特定清單。Gets or sets the specific list in the data source to which the connector currently binds to.

DataSource DataSource DataSource DataSource

取得或設定此連結器所繫結至的資料來源。Gets or sets the data source that the connector binds to.

DesignMode DesignMode DesignMode DesignMode

取得值,指出 Component 目前是否處於設計模式。Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

取得附加在這個 Component 上的事件處理常式清單。Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Filter Filter Filter Filter

取得或設定用來篩選檢視的資料列的運算式。Gets or sets the expression used to filter which rows are viewed.

IsBindingSuspended IsBindingSuspended IsBindingSuspended IsBindingSuspended

取得值,指出清單繫結是否已暫止。Gets a value indicating whether the list binding is suspended.

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

取得值,指出基礎清單是否有固定的大小。Gets a value indicating whether the underlying list has a fixed size.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

取得值,指出基礎清單是否為唯讀。Gets a value indicating whether the underlying list is read-only.

IsSorted IsSorted IsSorted IsSorted

取得值,指出是否已排序的基礎清單中的項目。Gets a value indicating whether the items in the underlying list are sorted.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

取得值,表示是否同步化存取集合 (執行緒安全)。Gets a value indicating whether access to the collection is synchronized (thread safe).

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

取得或設定指定索引中的清單項目。Gets or sets the list element at the specified index.

List List List List

取得連接器要繫結至其中的清單。Gets the list that the connector is bound to.

Position Position Position Position

取得或設定基礎清單中目前項目的索引。Gets or sets the index of the current item in the underlying list.

RaiseListChangedEvents RaiseListChangedEvents RaiseListChangedEvents RaiseListChangedEvents

取得或設定值,指出是否ListChanged應該引發事件。Gets or sets a value indicating whether ListChanged events should be raised.

Site Site Site Site

取得或設定 ComponentISiteGets or sets the ISite of the Component.

(Inherited from Component)
Sort Sort Sort Sort

取得或設定用來排序的資料行名稱,以及用來檢視資料來源中資料列的排序次序。Gets or sets the column names used for sorting, and the sort order for viewing the rows in the data source.

SortDescriptions SortDescriptions SortDescriptions SortDescriptions

取得套用至資料來源的排序描述集合。Gets the collection of sort descriptions applied to the data source.

SortDirection SortDirection SortDirection SortDirection

取得清單中項目排序的方向。Gets the direction the items in the list are sorted.

SortProperty SortProperty SortProperty SortProperty

取得PropertyDescriptor已經用來排序清單。Gets the PropertyDescriptor that is being used for sorting the list.

SupportsAdvancedSorting SupportsAdvancedSorting SupportsAdvancedSorting SupportsAdvancedSorting

取得值,指出資料來源是否支援多欄排序。Gets a value indicating whether the data source supports multi-column sorting.

SupportsChangeNotification SupportsChangeNotification SupportsChangeNotification SupportsChangeNotification

取得值,指出資料來源是否支援變更告知。Gets a value indicating whether the data source supports change notification.

SupportsFiltering SupportsFiltering SupportsFiltering SupportsFiltering

取得值,指出資料來源是否支援篩選。Gets a value indicating whether the data source supports filtering.

SupportsSearching SupportsSearching SupportsSearching SupportsSearching

取得值,指出資料來源是否支援搜尋與Find(PropertyDescriptor, Object)方法。Gets a value indicating whether the data source supports searching with the Find(PropertyDescriptor, Object) method.

SupportsSorting SupportsSorting SupportsSorting SupportsSorting

取得值,指出資料來源是否支援排序。Gets a value indicating whether the data source supports sorting.

SyncRoot SyncRoot SyncRoot SyncRoot

取得可用來同步對基礎清單存取的物件。Gets an object that can be used to synchronize access to the underlying list.

方法

Add(Object) Add(Object) Add(Object) Add(Object)

將現有項目加入內部清單中。Adds an existing item to the internal list.

AddNew() AddNew() AddNew() AddNew()

將新的項目加入基礎清單中。Adds a new item to the underlying list.

ApplySort(ListSortDescriptionCollection) ApplySort(ListSortDescriptionCollection) ApplySort(ListSortDescriptionCollection) ApplySort(ListSortDescriptionCollection)

使用指定的排序描述,對資料來源排序。Sorts the data source with the specified sort descriptions.

ApplySort(PropertyDescriptor, ListSortDirection) ApplySort(PropertyDescriptor, ListSortDirection) ApplySort(PropertyDescriptor, ListSortDirection) ApplySort(PropertyDescriptor, ListSortDirection)

使用指定的屬性描述項和排序方向,對資料來源排序。Sorts the data source using the specified property descriptor and sort direction.

CancelEdit() CancelEdit() CancelEdit() CancelEdit()

取消目前的編輯作業。Cancels the current edit operation.

Clear() Clear() Clear() Clear()

將所有項目從清單中移除。Removes all elements from the list.

Contains(Object) Contains(Object) Contains(Object) Contains(Object)

判斷某個物件是否為清單中的項目。Determines whether an object is an item in the list.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

內容複製List到指定的陣列,從指定的索引值開始。Copies the contents of the List to the specified array, starting at the specified index value.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

建立包含所有相關資訊的物件,這些資訊是產生用來與遠端物件通訊的所需 Proxy。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

釋放 Component 所使用的所有資源。Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

釋放 BindingSource 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。Releases the unmanaged resources used by the BindingSource and optionally releases the managed resources.

EndEdit() EndEdit() EndEdit() EndEdit()

將暫止的變更套用至基礎資料來源。Applies pending changes to the underlying data source.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object)

搜尋具有指定屬性描述項的項目之索引。Searches for the index of the item that has the given property descriptor.

Find(String, Object) Find(String, Object) Find(String, Object) Find(String, Object)

傳回清單中具有指定屬性名稱和值的項目之索引。Returns the index of the item in the list with the specified property name and value.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

擷取列舉值ListRetrieves an enumerator for the List.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(Inherited from Object)
GetItemProperties(PropertyDescriptor[]) GetItemProperties(PropertyDescriptor[]) GetItemProperties(PropertyDescriptor[]) GetItemProperties(PropertyDescriptor[])

擷取陣列PropertyDescriptor物件,代表可繫結屬性與資料來源清單類型。Retrieves an array of PropertyDescriptor objects representing the bindable properties of the data source list type.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetListName(PropertyDescriptor[]) GetListName(PropertyDescriptor[]) GetListName(PropertyDescriptor[]) GetListName(PropertyDescriptor[])

取得為繫結提供資料的清單名稱。Gets the name of the list supplying data for the binding.

GetRelatedCurrencyManager(String) GetRelatedCurrencyManager(String) GetRelatedCurrencyManager(String) GetRelatedCurrencyManager(String)

取得指定之資料成員的相關 Currency 管理員。Gets the related currency manager for the specified data member.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

傳回表示 Component 或其 Container 所提供之服務的物件。Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(Inherited from Object)
IndexOf(Object) IndexOf(Object) IndexOf(Object) IndexOf(Object)

搜尋指定的物件,並傳回整個清單中第一個相符項目的索引。Searches for the specified object and returns the index of the first occurrence within the entire list.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

取得存留期服務物件,以控制這個執行個體的存留期原則。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Insert(Int32, Object) Insert(Int32, Object) Insert(Int32, Object) Insert(Int32, Object)

將項目插入位於指定索引的清單中。Inserts an item into the list at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

建立目前 Object 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

建立目前 MarshalByRefObject 物件的淺層複本。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MoveFirst() MoveFirst() MoveFirst() MoveFirst()

移至清單中的第一個項目。Moves to the first item in the list.

MoveLast() MoveLast() MoveLast() MoveLast()

移至清單中的最後一個項目。Moves to the last item in the list.

MoveNext() MoveNext() MoveNext() MoveNext()

移至清單中的下一個項目。Moves to the next item in the list.

MovePrevious() MovePrevious() MovePrevious() MovePrevious()

移至清單中的上一個項目。Moves to the previous item in the list.

OnAddingNew(AddingNewEventArgs) OnAddingNew(AddingNewEventArgs) OnAddingNew(AddingNewEventArgs) OnAddingNew(AddingNewEventArgs)

引發 AddingNew 事件。Raises the AddingNew event.

OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs)

引發 BindingComplete 事件。Raises the BindingComplete event.

OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs)

引發 CurrentChanged 事件。Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs)

引發 CurrentItemChanged 事件。Raises the CurrentItemChanged event.

OnDataError(BindingManagerDataErrorEventArgs) OnDataError(BindingManagerDataErrorEventArgs) OnDataError(BindingManagerDataErrorEventArgs) OnDataError(BindingManagerDataErrorEventArgs)

引發 DataError 事件。Raises the DataError event.

OnDataMemberChanged(EventArgs) OnDataMemberChanged(EventArgs) OnDataMemberChanged(EventArgs) OnDataMemberChanged(EventArgs)

引發 DataMemberChanged 事件。Raises the DataMemberChanged event.

OnDataSourceChanged(EventArgs) OnDataSourceChanged(EventArgs) OnDataSourceChanged(EventArgs) OnDataSourceChanged(EventArgs)

引發 DataSourceChanged 事件。Raises the DataSourceChanged event.

OnListChanged(ListChangedEventArgs) OnListChanged(ListChangedEventArgs) OnListChanged(ListChangedEventArgs) OnListChanged(ListChangedEventArgs)

引發 ListChanged 事件。Raises the ListChanged event.

OnPositionChanged(EventArgs) OnPositionChanged(EventArgs) OnPositionChanged(EventArgs) OnPositionChanged(EventArgs)

引發 PositionChanged 事件。Raises the PositionChanged event.

Remove(Object) Remove(Object) Remove(Object) Remove(Object)

從清單中移除指定的項目。Removes the specified item from the list.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

移除清單中位於指定索引上的項目。Removes the item at the specified index in the list.

RemoveCurrent() RemoveCurrent() RemoveCurrent() RemoveCurrent()

從清單中移除目前項目。Removes the current item from the list.

RemoveFilter() RemoveFilter() RemoveFilter() RemoveFilter()

移除與相關聯的篩選條件BindingSourceRemoves the filter associated with the BindingSource.

RemoveSort() RemoveSort() RemoveSort() RemoveSort()

移除與相關聯的排序BindingSourceRemoves the sort associated with the BindingSource.

ResetAllowNew() ResetAllowNew() ResetAllowNew() ResetAllowNew()

重新初始化AllowNew屬性。Reinitializes the AllowNew property.

ResetBindings(Boolean) ResetBindings(Boolean) ResetBindings(Boolean) ResetBindings(Boolean)

使得繫結至 BindingSource 的控制項重新讀取清單中的所有項目,並重新整理其顯示的值。Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.

ResetCurrentItem() ResetCurrentItem() ResetCurrentItem() ResetCurrentItem()

使繫結至控制項BindingSource重新讀取目前選取的項目,並重新整理其顯示的值。Causes a control bound to the BindingSource to reread the currently selected item and refresh its displayed value.

ResetItem(Int32) ResetItem(Int32) ResetItem(Int32) ResetItem(Int32)

使繫結至控制項BindingSource重新讀取指定索引處的項目,並重新整理其顯示的值。Causes a control bound to the BindingSource to reread the item at the specified index, and refresh its displayed value.

ResumeBinding() ResumeBinding() ResumeBinding() ResumeBinding()

繼續資料繫結。Resumes data binding.

SuspendBinding() SuspendBinding() SuspendBinding() SuspendBinding()

暫止資料繫結以防止變更更新繫結的資料來源。Suspends data binding to prevent changes from updating the bound data source.

ToString() ToString() ToString() ToString()

傳回任何包含 Component 名稱的 StringReturns a String containing the name of the Component, if any. 不應覆寫此方法。This method should not be overridden.

(Inherited from Component)

事件

AddingNew AddingNew AddingNew AddingNew

在項目加入基礎清單之前發生。Occurs before an item is added to the underlying list.

BindingComplete BindingComplete BindingComplete BindingComplete

發生於所有的用戶端都已繫結至此BindingSourceOccurs when all the clients have been bound to this BindingSource.

CurrentChanged CurrentChanged CurrentChanged CurrentChanged

發生於目前繫結的項目變更時。Occurs when the currently bound item changes.

CurrentItemChanged CurrentItemChanged CurrentItemChanged CurrentItemChanged

屬性值時,就會發生Current屬性已變更。Occurs when a property value of the Current property has changed.

DataError DataError DataError DataError

以無訊息模式會處理與貨幣有關的例外狀況時,就會發生BindingSourceOccurs when a currency-related exception is silently handled by the BindingSource.

DataMemberChanged DataMemberChanged DataMemberChanged DataMemberChanged

發生於 DataMember 屬性值變更時。Occurs when the DataMember property value has changed.

DataSourceChanged DataSourceChanged DataSourceChanged DataSourceChanged

發生於 DataSource 屬性值變更時。Occurs when the DataSource property value has changed.

Disposed Disposed Disposed Disposed

當此元件由 Dispose() 方法的呼叫處置時發生。Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
ListChanged ListChanged ListChanged ListChanged

發生於基礎清單有變更或清單中的項目有變更時。Occurs when the underlying list changes or an item in the list changes.

PositionChanged PositionChanged PositionChanged PositionChanged

值之後,就會發生Position屬性已變更。Occurs after the value of the Position property has changed.

明確介面實作

IBindingList.AddIndex(PropertyDescriptor) IBindingList.AddIndex(PropertyDescriptor) IBindingList.AddIndex(PropertyDescriptor) IBindingList.AddIndex(PropertyDescriptor)

新增PropertyDescriptor用於搜尋的索引。Adds the PropertyDescriptor to the indexes used for searching.

IBindingList.RemoveIndex(PropertyDescriptor) IBindingList.RemoveIndex(PropertyDescriptor) IBindingList.RemoveIndex(PropertyDescriptor) IBindingList.RemoveIndex(PropertyDescriptor)

移除PropertyDescriptor從用來搜尋的索引。Removes the PropertyDescriptor from the indexes used for searching.

ICancelAddNew.CancelNew(Int32) ICancelAddNew.CancelNew(Int32) ICancelAddNew.CancelNew(Int32) ICancelAddNew.CancelNew(Int32)

從集合中捨棄暫止的新項目。Discards a pending new item from the collection.

ICancelAddNew.EndNew(Int32) ICancelAddNew.EndNew(Int32) ICancelAddNew.EndNew(Int32) ICancelAddNew.EndNew(Int32)

將暫止的新項目認可到集合中。Commits a pending new item to the collection.

ISupportInitialize.BeginInit() ISupportInitialize.BeginInit() ISupportInitialize.BeginInit() ISupportInitialize.BeginInit()

訊號BindingSource表示正在啟動初始化。Signals the BindingSource that initialization is starting.

ISupportInitialize.EndInit() ISupportInitialize.EndInit() ISupportInitialize.EndInit() ISupportInitialize.EndInit()

訊號BindingSource表示初始化已完成。Signals the BindingSource that initialization is complete.

ISupportInitializeNotification.Initialized ISupportInitializeNotification.Initialized ISupportInitializeNotification.Initialized ISupportInitializeNotification.Initialized

發生時BindingSource初始化。Occurs when the BindingSource is initialized.

ISupportInitializeNotification.IsInitialized ISupportInitializeNotification.IsInitialized ISupportInitializeNotification.IsInitialized ISupportInitializeNotification.IsInitialized

取得值,指出是否已初始化 BindingSourceGets a value indicating whether the BindingSource is initialized.

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

IEnumerable 的項目轉換成指定的型別。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

根據指定的型別來篩選 IEnumerable 的項目。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

啟用查詢的平行化作業。Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

將轉換IEnumerableIQueryableConverts an IEnumerable to an IQueryable.

適用於

另請參閱