BindingSource 클래스

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

BindingSource.cs

폼의 데이터 소스를 캡슐화합니다.

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

상속

Object

MarshalByRefObject

Component

BindingSource

특성

ComplexBindingPropertiesAttribute

구현

ICollection IEnumerable IList IBindingList IBindingListView ICancelAddNew ISupportInitialize ISupportInitializeNotification ITypedList ICurrencyManagerProvider

예제

다음 코드 예제는 ListBox 바인딩되는 BindingSource. 합니다 BindingSource 바인딩되는 BindingList<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)
            {
                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

설명

BindingSource 구성 요소는 여러 용도로 사용 됩니다. 첫째, 통화 관리, 변경 알림 및 Windows Forms 컨트롤 및 데이터 원본 간에 다른 서비스를 제공 하 여 데이터를 폼에 컨트롤 바인딩 간소화 합니다. 연결 하 여 이렇게 합니다 BindingSource 구성 요소를 사용 하 여 데이터 소스를 DataSource 속성. 복잡 한 바인딩 시나리오를 선택적으로 설정할 수는 DataMember 특정 열 또는 목록 데이터 원본에 대 한 속성입니다. 컨트롤을 바인딩하고 BindingSource합니다. 데이터를 사용 하 여 모든 상호 작용에 대 한 호출을 사용 하 여 수행 됩니다는 BindingSource 구성 요소입니다. 방법에 대 한 예제 BindingSource 을 참조 하십시오 바인딩 프로세스를 단순화할 수 있습니다 방법: DBNull 데이터베이스 값에 Windows Forms 컨트롤 바인딩 및 방법: 오류 처리 및 예외데이터바인딩에서발생하는. 탐색 및 데이터 원본의 업데이트와 같은 메서드를 통해 수행 됩니다 MoveNext하십시오 MoveLast, 및 Remove합니다. 정렬 및 필터링 같은 작업을 통해 처리 되는 Sort 및 Filter 속성입니다. 정렬 및 필터링을 사용 하 여 대 한 자세한 내용은 합니다 BindingSource, 참조 방법: 데이터 정렬 및 필터링 ADO.NET Windows Forms BindingSource 구성 요소를 사용 하 여합니다.

또한는 BindingSource 구성 요소는 강력한 형식의 데이터 소스로 사용할 수 있습니다. 일반적으로 다음 메커니즘 중 하나를 통해 데이터 원본 유형의 고정 됩니다.

• 사용 합니다 Add 항목을 추가 하는 방법의 BindingSource 구성 요소입니다.

• 설정 된 DataSource 목록, 단일 개체 또는 형식 속성입니다.

이러한 메커니즘 중 둘 다 강력한 형식의 목록을 만듭니다. 사용 하는 방법에 대 한 자세한 내용은 합니다 BindingSource 참조 형식에 바인딩할 방법: 형식에는 Windows Forms 컨트롤 바인딩합니다. 사용할 수도 있습니다는 BindingSource 팩터리 개체에 컨트롤을 바인딩할 합니다. 이 작업을 수행 하는 방법에 대 한 자세한 내용은 참조 하세요. 방법: Windows Forms 컨트롤을 팩터리 개체를 바인딩할합니다.

참고

때문에 BindingSource 핸들 용어 단순 및 복합 데이터 원본 모두 문제가 될 수 있습니다. 이 클래스 설명서 내에서 용어 목록 호스팅된 데이터 원본 내에서 데이터 컬렉션을 참조 하 고 항목 단일 요소를 나타냅니다. 경우 기능을 설명할 연결 된 복잡 한 데이터 원본과 같은 의미로 테이블 하 고 행 사용 됩니다.

BindingSource 기본 데이터에 액세스 하기 위한 멤버를 제공 합니다. 현재 항목을 검색할 수는 Current 전체 목록과 속성을 통해 검색할 수 있습니다는 List 속성입니다. 편집 작업을 통해 현재 항목에서 지원 됩니다 Current 하며 RemoveCurrent를 EndEdit를 CancelEdit 및 Add 및 AddNew 메서드. 위치 관리는 모든 기본 데이터 원본 유형에 대 한 자동으로 처리 되지만이 클래스는 이벤트와 같은 CurrentItemChanged 및 DataSourceChanged를 사용자 지정할 수 있도록 합니다.

데이터 원본에 바인딩되는 BindingSource 구성 요소 또한 탐색 하 고 관리할 수 있는 BindingNavigator 목록 내의 항목을 탐색 하기 위한 VCR 형태의 사용자 인터페이스 (UI)를 제공 하는 클래스. 하지만 BindingNavigator 바인딩될 수와 통합 하도록 설계 된 모든 데이터 원본에는 BindingSource 구성 요소를 통해 해당 BindingNavigator.BindingSource 속성.

에 대 한 기본 속성을 BindingSource 클래스는 DataSource합니다. 기본 이벤트는 CurrentChanged합니다.

주의

멤버는 대부분를 BindingSource 클래스를 나타내는 기본 목록에서 작동 합니다 List 속성 단순히 내부 목록에 해당 작업을 참조 합니다. 따라서 경우 합니다 BindingSource 의 사용자 지정 구현에 바인딩되어 IList, 이러한 멤버의 정확한 동작은 클래스 설명서에 설명 된 동작에서 다를 수 있습니다. 예를 들어 합니다 RemoveAt 메서드 호출 IList.RemoveAt합니다. BindingSource 설명서에 설명 합니다는 RemoveAt 이해를 사용 하 여 메서드는는 RemoveAt 기본 메서드 IList 정확 하 게 구현 됩니다.

생성자

BindingSource()	BindingSource 클래스의 새 인스턴스를 기본 속성 값으로 초기화합니다.
BindingSource(IContainer)	BindingSource 클래스의 새 인스턴스를 초기화하고 지정된 컨테이너에 BindingSource를 추가합니다.
BindingSource(Object, String)	지정된 데이터 소스와 데이터 멤버를 사용하여 BindingSource 클래스의 새 인스턴스를 초기화합니다.

속성

AllowEdit	내부 목록의 항목을 편집할 수 있는지를 나타내는 값을 가져옵니다.
AllowNew	AddNew() 메서드를 사용하여 목록에 항목을 추가할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
AllowRemove	내부 목록에서 항목을 제거할 수 있는지를 나타내는 값을 가져옵니다.
CanRaiseEvents	구성 요소가 이벤트를 발생시킬 수 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component)
Container	IContainer을 포함하는 Component를 가져옵니다. (다음에서 상속됨 Component)
Count	현재 Filter 값을 고려하여 기본 목록의 총 항목 수를 가져옵니다.
CurrencyManager	BindingSource와 연결된 현재 위치 관리자를 가져옵니다.
Current	목록의 현재 항목을 가져옵니다.
DataMember	커넥터가 현재 바인딩된 데이터 소스의 특정 목록을 가져오거나 설정합니다.
DataSource	커넥터가 바인딩된 데이터 소스를 가져오거나 설정합니다.
DesignMode	Component가 현재 디자인 모드인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Component)
Events	이 Component에 연결된 이벤트 처리기의 목록을 가져옵니다. (다음에서 상속됨 Component)
Filter	표시할 행을 필터링하는 데 사용하는 식을 가져오거나 설정합니다.
IsBindingSuspended	목록 바인딩이 일시 중단되는지를 나타내는 값을 가져옵니다.
IsFixedSize	내부 목록의 크기가 고정되어 있는지를 나타내는 값을 가져옵니다.
IsReadOnly	내부 목록이 읽기 전용인지를 나타내는 값을 가져옵니다.
IsSorted	기본 목록의 항목이 정렬되는지 여부를 나타내는 값을 가져옵니다.
IsSynchronized	해당 컬렉션에 대한 액세스가 동기화되어 스레드로부터 안전하게 보호되는지를 나타내는 값을 가져옵니다.
Item[Int32]	지정된 인덱스에 있는 목록 요소를 가져오거나 설정합니다.
List	커넥터가 바인딩된 목록을 가져옵니다.
Position	내부 목록에 있는 현재 항목의 인덱스를 가져오거나 설정합니다.
RaiseListChangedEvents	ListChanged 이벤트가 발생할지 여부를 나타내는 값을 가져오거나 설정합니다.
Site	Component의 ISite를 가져오거나 설정합니다. (다음에서 상속됨 Component)
Sort	정렬에 사용되는 열 이름과 데이터 소스의 행을 표시하기 위한 정렬 순서를 가져오거나 설정합니다.
SortDescriptions	데이터 소스에 적용된 정렬 설명의 컬렉션을 가져옵니다.
SortDirection	목록의 항목이 정렬되는 방향을 가져옵니다.
SortProperty	목록을 정렬하는 데 사용되는 PropertyDescriptor를 가져옵니다.
SupportsAdvancedSorting	데이터 소스에서 여러 열 정렬을 지원하는지를 나타내는 값을 가져옵니다.
SupportsChangeNotification	데이터 소스에서 변경 알림을 지원하는지를 나타내는 값을 가져옵니다.
SupportsFiltering	데이터 소스에서 필터링을 지원하는지 여부를 나타내는 값을 가져옵니다.
SupportsSearching	데이터 소스에서 Find(PropertyDescriptor, Object) 메서드를 사용한 검색을 지원하는지 여부를 나타내는 값을 가져옵니다.
SupportsSorting	데이터 소스에서 정렬을 지원하는지를 나타내는 값을 가져옵니다.
SyncRoot	내부 목록에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.

메서드

Add(Object)	내부 목록에 기존 항목을 추가합니다.
AddNew()	내부 목록에 새 항목을 추가합니다.
ApplySort(ListSortDescriptionCollection)	지정된 정렬 설명을 사용하여 데이터 소스를 정렬합니다.
ApplySort(PropertyDescriptor, ListSortDirection)	지정된 속성 설명자 또는 정렬 방향을 사용하여 데이터 소스를 정렬합니다.
CancelEdit()	현재 편집 작업을 취소합니다.
Clear()	목록에서 모든 요소를 제거합니다.
Contains(Object)	개체가 목록에 있는 항목인지를 확인합니다.
CopyTo(Array, Int32)	지정된 인덱스 값에서 시작하여 List의 내용을 지정된 배열에 복사합니다.
CreateObjRef(Type)	원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject)
Dispose()	Component에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 Component)
Dispose(Boolean)	BindingSource에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.
EndEdit()	내부 데이터 소스에 보류 중인 변경 내용을 적용합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
Find(PropertyDescriptor, Object)	지정된 속성 설명자가 있는 항목의 인덱스를 검색합니다.
Find(String, Object)	목록에서 지정된 속성 이름 및 값을 가진 항목의 인덱스를 반환합니다.
GetEnumerator()	List에 대한 열거자를 검색합니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetItemProperties(PropertyDescriptor[])	데이터 소스 목록 형식의 바인딩 가능한 속성을 나타내는 PropertyDescriptor 개체의 배열을 검색합니다.
GetLifetimeService()	이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject)
GetListName(PropertyDescriptor[])	바인딩에 대한 데이터를 제공하는 목록 이름을 가져옵니다.
GetRelatedCurrencyManager(String)	지정된 데이터 멤버와 관련된 현재 위치 관리자를 가져옵니다.
GetService(Type)	Component 또는 해당 Container에서 제공하는 서비스를 나타내는 개체를 반환합니다. (다음에서 상속됨 Component)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
IndexOf(Object)	지정한 개체를 검색하여 목록 전체에서 처음 검색된 개체의 인덱스를 반환합니다.
InitializeLifetimeService()	이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject)
Insert(Int32, Object)	목록 내의 지정된 인덱스에 항목을 삽입합니다.
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
MemberwiseClone(Boolean)	현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject)
MoveFirst()	목록의 첫 번째 항목으로 이동합니다.
MoveLast()	목록의 마지막 항목으로 이동합니다.
MoveNext()	목록의 다음 항목으로 이동합니다.
MovePrevious()	목록의 이전 항목으로 이동합니다.
OnAddingNew(AddingNewEventArgs)	AddingNew 이벤트를 발생시킵니다.
OnBindingComplete(BindingCompleteEventArgs)	BindingComplete 이벤트를 발생시킵니다.
OnCurrentChanged(EventArgs)	CurrentChanged 이벤트를 발생시킵니다.
OnCurrentItemChanged(EventArgs)	CurrentItemChanged 이벤트를 발생시킵니다.
OnDataError(BindingManagerDataErrorEventArgs)	DataError 이벤트를 발생시킵니다.
OnDataMemberChanged(EventArgs)	DataMemberChanged 이벤트를 발생시킵니다.
OnDataSourceChanged(EventArgs)	DataSourceChanged 이벤트를 발생시킵니다.
OnListChanged(ListChangedEventArgs)	ListChanged 이벤트를 발생시킵니다.
OnPositionChanged(EventArgs)	PositionChanged 이벤트를 발생시킵니다.
Remove(Object)	지정된 항목을 목록에서 제거합니다.
RemoveAt(Int32)	목록의 지정된 인덱스에 있는 항목을 제거합니다.
RemoveCurrent()	목록에서 현재 항목을 제거합니다.
RemoveFilter()	BindingSource와 연결된 필터를 제거합니다.
RemoveSort()	BindingSource와 연결된 정렬을 제거합니다.
ResetAllowNew()	AllowNew 속성을 다시 초기화합니다.
ResetBindings(Boolean)	BindingSource에 바인딩된 컨트롤에서 목록의 모든 항목을 다시 읽고 표시된 값을 새로 고치도록 합니다.
ResetCurrentItem()	BindingSource에 바인딩된 컨트롤에서 현재 선택된 항목을 다시 읽고 표시된 값을 새로 고치도록 합니다.
ResetItem(Int32)	BindingSource에 바인딩된 컨트롤에서 지정된 인덱스에 있는 항목을 다시 읽고 표시된 값을 새로 고치도록 합니다.
ResumeBinding()	데이터 바인딩을 다시 시작합니다.
SuspendBinding()	데이터 바인딩을 일시 중단하여 바인딩된 데이터 소스가 변경 내용으로 업데이트되지 않도록 합니다.
ToString()	Component의 이름이 포함된 String을 반환합니다(있는 경우). 이 메서드는 재정의할 수 없습니다. (다음에서 상속됨 Component)

이벤트

AddingNew	항목이 내부 목록에 추가되기 전에 발생합니다.
BindingComplete	모든 클라이언트가 이 BindingSource에 바인딩되면 발생합니다.
CurrentChanged	현재 바인딩된 항목이 변경되면 발생합니다.
CurrentItemChanged	Current 속성 값이 변경되면 발생합니다.
DataError	통화 관련 예외가 BindingSource에서 자동으로 처리될 때 발생합니다.
DataMemberChanged	DataMember 속성 값이 변경되면 발생합니다.
DataSourceChanged	DataSource 속성 값이 변경되면 발생합니다.
Disposed	Dispose() 메서드를 호출하여 구성 요소를 삭제할 때 발생합니다. (다음에서 상속됨 Component)
ListChanged	내부 목록 또는 목록의 항목이 변경되면 발생합니다.
PositionChanged	Position 속성 값이 변경된 후에 발생합니다.

명시적 인터페이스 구현

IBindingList.AddIndex(PropertyDescriptor)	검색에 사용되는 인덱스에 PropertyDescriptor를 추가합니다.
IBindingList.RemoveIndex(PropertyDescriptor)	검색에 사용되는 인덱스에서 PropertyDescriptor를 제거합니다.
ICancelAddNew.CancelNew(Int32)	보류 중인 새 항목을 컬렉션에서 삭제합니다.
ICancelAddNew.EndNew(Int32)	보류 중인 새 항목을 컬렉션에 커밋합니다.
ISupportInitialize.BeginInit()	초기화가 시작됨을 BindingSource에 알립니다.
ISupportInitialize.EndInit()	초기화가 완료되었음을 BindingSource에 알립니다.
ISupportInitializeNotification.Initialized	BindingSource가 초기화될 때 발생합니다.
ISupportInitializeNotification.IsInitialized	BindingSource이 초기화되는지 여부를 나타내는 값을 가져옵니다.

확장 메서드

추가 정보

• BindingSource
• BindingNavigator
• DataGridView
• CurrencyManager
• IList
• IBindingList
• IEditableObject
• BindingSource 구성 요소