BindingList<T> 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
데이터 바인딩을 지원하는 제네릭 컬렉션을 제공합니다.
generic <typename T>
public ref class BindingList : System::Collections::ObjectModel::Collection<T>, System::ComponentModel::IBindingList, System::ComponentModel::ICancelAddNew, System::ComponentModel::IRaiseItemChangedEventspublic class BindingList<T> : System.Collections.ObjectModel.Collection<T>, System.ComponentModel.IBindingList, System.ComponentModel.ICancelAddNew, System.ComponentModel.IRaiseItemChangedEvents[System.Serializable]
public class BindingList<T> : System.Collections.ObjectModel.Collection<T>, System.ComponentModel.IBindingList, System.ComponentModel.ICancelAddNew, System.ComponentModel.IRaiseItemChangedEventstype BindingList<'T> = class
inherit Collection<'T>
interface ICollection
interface IEnumerable
interface IList
interface IBindingList
interface ICancelAddNew
interface IRaiseItemChangedEvents[<System.Serializable>]
type BindingList<'T> = class
inherit Collection<'T>
interface IBindingList
interface IList
interface ICollection
interface IEnumerable
interface ICancelAddNew
interface IRaiseItemChangedEventsPublic Class BindingList(Of T)
Inherits Collection(Of T)
Implements IBindingList, ICancelAddNew, IRaiseItemChangedEvents형식 매개 변수
- T
목록에 있는 요소의 형식입니다.
- 상속
- 특성
- 구현
예제
다음 코드 예제에서는 비즈니스 개체를 포함하는 구성 요소에 BindingList<T> 바인딩하는 방법을 보여 줍니다. 메서드를 포함하는 전체 예제입니다 Main .
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
namespace BindingListOfTExamples
{
public partial class Form1 : Form
{
private TextBox textBox2;
private ListBox listBox1;
private Button button1;
private TextBox textBox1;
Random randomNumber = new Random();
public Form1()
{
this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
this.textBox1 = new System.Windows.Forms.TextBox();
this.textBox2 = new System.Windows.Forms.TextBox();
this.listBox1 = new System.Windows.Forms.ListBox();
this.button1 = new System.Windows.Forms.Button();
this.textBox1.Location = new System.Drawing.Point(169, 26);
this.textBox1.Size = new System.Drawing.Size(100, 20);
this.textBox1.Text = "Bracket";
this.textBox2.Location = new System.Drawing.Point(169, 57);
this.textBox2.ReadOnly = true;
this.textBox2.Size = new System.Drawing.Size(100, 20);
this.textBox2.Text = "4343";
this.listBox1.FormattingEnabled = true;
this.listBox1.Location = new System.Drawing.Point(12, 12);
this.listBox1.Size = new System.Drawing.Size(120, 95);
this.button1.Location = new System.Drawing.Point(180, 83);
this.button1.Size = new System.Drawing.Size(75, 23);
this.button1.Text = "Add New Item";
this.button1.Click += new System.EventHandler(this.button1_Click);
this.ClientSize = new System.Drawing.Size(292, 266);
this.Controls.Add(this.button1);
this.Controls.Add(this.listBox1);
this.Controls.Add(this.textBox2);
this.Controls.Add(this.textBox1);
this.Text = "Parts Form";
this.Load += new EventHandler(Form1_Load);
}
void Form1_Load(object sender, EventArgs e)
{
InitializeListOfParts();
listBox1.DataSource = listOfParts;
listBox1.DisplayMember = "PartName";
listOfParts.AddingNew += new AddingNewEventHandler(listOfParts_AddingNew);
listOfParts.ListChanged += new ListChangedEventHandler(listOfParts_ListChanged);
}
// Declare a new BindingListOfT with the Part business object.
BindingList<Part> listOfParts;
private void InitializeListOfParts()
{
// Create the new BindingList of Part type.
listOfParts = new BindingList<Part>();
// Allow new parts to be added, but not removed once committed.
listOfParts.AllowNew = true;
listOfParts.AllowRemove = false;
// Raise ListChanged events when new parts are added.
listOfParts.RaiseListChangedEvents = true;
// Do not allow parts to be edited.
listOfParts.AllowEdit = false;
// Add a couple of parts to the list.
listOfParts.Add(new Part("Widget", 1234));
listOfParts.Add(new Part("Gadget", 5647));
}
// Create a new part from the text in the two text boxes.
void listOfParts_AddingNew(object sender, AddingNewEventArgs e)
{
e.NewObject = new Part(textBox1.Text, int.Parse(textBox2.Text));
}
// Add the new part unless the part number contains
// spaces. In that case cancel the add.
private void button1_Click(object sender, EventArgs e)
{
Part newPart = listOfParts.AddNew();
if (newPart.PartName.Contains(" "))
{
MessageBox.Show("Part names cannot contain spaces.");
listOfParts.CancelNew(listOfParts.IndexOf(newPart));
}
else
{
textBox2.Text = randomNumber.Next(9999).ToString();
textBox1.Text = "Enter part name";
}
}
void listOfParts_ListChanged(object sender, ListChangedEventArgs e)
{
MessageBox.Show(e.ListChangedType.ToString());
}
[STAThread]
static void Main()
{
Application.EnableVisualStyles();
Application.Run(new Form1());
}
}
// A simple business object for example purposes.
public class Part
{
private string name;
private int number;
public Part() { }
public Part(string nameForPart, int numberForPart)
{
PartName = nameForPart;
PartNumber = numberForPart;
}
public string PartName
{
get { return name; }
set { name = value; }
}
public int PartNumber
{
get { return number; }
set { number = value; }
}
}
}
Option Explicit On
Option Strict On
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Drawing
Imports System.Text
Imports System.Windows.Forms
Class Form1
Inherits Form
Private textBox2 As TextBox
Private listBox1 As ListBox
Private WithEvents button1 As Button
Private textBox1 As TextBox
Private randomNumber As New Random()
Public Sub New()
Me.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font
Me.textBox1 = New System.Windows.Forms.TextBox()
Me.textBox2 = New System.Windows.Forms.TextBox()
Me.listBox1 = New System.Windows.Forms.ListBox()
Me.button1 = New System.Windows.Forms.Button()
Me.textBox1.Location = New System.Drawing.Point(169, 26)
Me.textBox1.Size = New System.Drawing.Size(100, 20)
Me.textBox1.Text = "Bracket"
Me.textBox2.Location = New System.Drawing.Point(169, 57)
Me.textBox2.ReadOnly = True
Me.textBox2.Size = New System.Drawing.Size(100, 20)
Me.textBox2.Text = "4343"
Me.listBox1.FormattingEnabled = True
Me.listBox1.Location = New System.Drawing.Point(12, 12)
Me.listBox1.Size = New System.Drawing.Size(120, 95)
Me.button1.Location = New System.Drawing.Point(180, 83)
Me.button1.Size = New System.Drawing.Size(75, 23)
Me.button1.Text = "Add New Item"
Me.ClientSize = New System.Drawing.Size(292, 266)
Me.Controls.Add(Me.button1)
Me.Controls.Add(Me.listBox1)
Me.Controls.Add(Me.textBox2)
Me.Controls.Add(Me.textBox1)
Me.Text = "Parts Form"
AddHandler Me.Load, AddressOf Form1_Load
End Sub
Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
InitializeListOfParts()
listBox1.DataSource = listOfParts
listBox1.DisplayMember = "PartName"
End Sub
' Declare a new BindingListOfT with the Part business object.
Private WithEvents listOfParts As BindingList(Of Part)
Private Sub InitializeListOfParts()
' Create the new BindingList of Part type.
listOfParts = New BindingList(Of Part)
' Allow new parts to be added, but not removed once committed.
listOfParts.AllowNew = True
listOfParts.AllowRemove = False
' Raise ListChanged events when new parts are added.
listOfParts.RaiseListChangedEvents = True
' Do not allow parts to be edited.
listOfParts.AllowEdit = False
' Add a couple of parts to the list.
listOfParts.Add(New Part("Widget", 1234))
listOfParts.Add(New Part("Gadget", 5647))
End Sub
' Create a new part from the text in the two text boxes.
Private Sub listOfParts_AddingNew(ByVal sender As Object, _
ByVal e As AddingNewEventArgs) Handles listOfParts.AddingNew
e.NewObject = New Part(textBox1.Text, Integer.Parse(textBox2.Text))
End Sub
' Add the new part unless the part number contains
' spaces. In that case cancel the add.
Private Sub button1_Click(ByVal sender As Object, _
ByVal e As EventArgs) Handles button1.Click
Dim newPart As Part = listOfParts.AddNew()
If newPart.PartName.Contains(" ") Then
MessageBox.Show("Part names cannot contain spaces.")
listOfParts.CancelNew(listOfParts.IndexOf(newPart))
Else
textBox2.Text = randomNumber.Next(9999).ToString()
textBox1.Text = "Enter part name"
End If
End Sub
<STAThread()> _
Shared Sub Main()
Application.EnableVisualStyles()
Application.Run(New Form1())
End Sub
End Class
' A simple business object for example purposes.
Public Class Part
Private name As String
Private number As Integer
Public Sub New()
End Sub
Public Sub New(ByVal nameForPart As String, _
ByVal numberForPart As Integer)
PartName = nameForPart
PartNumber = numberForPart
End Sub
Public Property PartName() As String
Get
Return name
End Get
Set(ByVal value As String)
name = Value
End Set
End Property
Public Property PartNumber() As Integer
Get
Return number
End Get
Set(ByVal value As Integer)
number = Value
End Set
End Property
End Class
설명
클래스를 BindingList<T> 기본 클래스로 사용하여 양방향 데이터 바인딩 메커니즘을 만들 수 있습니다. BindingList<T> 는 인터페이스의 구체적인 제네릭 구현을 IBindingList 제공합니다. 이는 , IEditableObject및 연결된 CurrencyManager간의 IBindingList미묘한 상호 작용으로 인해 어려울 수 있는 전체 IBindingList 인터페이스를 구현하는 대안입니다. 그러나 일반적인 솔루션 프로그래머가 를 직접 사용하는 대신 과 같은 BindingSource데이터 바인딩 기능을 제공하는 클래스를 사용합니다 BindingList<T>.
BindingList<T> 는 확장 가능한 AddNew 메서드를 통해 팩터리에서 만든 인스턴스를 지원합니다. (이 동일한 유형의 확장성은 와 같은 BindingSource다른 클래스에서도 찾을 수 있습니다.) 또한 이 클래스는 인터페이스를 ICancelAddNew 구현하므로 및 CancelNew 메서드를 통해 새 항목의 트랜잭션 커밋 또는 롤백을 EndNew 사용하도록 설정합니다.
생성자
| BindingList<T>() |
기본값을 사용하여 BindingList<T> 클래스의 새 인스턴스를 초기화합니다. |
| BindingList<T>(IList<T>) |
지정한 목록을 사용하여 BindingList<T> 클래스의 새 인스턴스를 초기화합니다. |
속성
| AllowEdit |
목록의 항목을 편집할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| AllowNew |
AddNew() 메서드를 사용하여 목록에 항목을 추가할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| AllowRemove |
컬렉션에서 항목을 제거할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| Count |
Collection<T>에 실제로 포함된 요소의 수를 가져옵니다. (다음에서 상속됨 Collection<T>) |
| IsSortedCore |
목록이 정렬되어 있는지 여부를 나타내는 값을 가져옵니다. |
| Item[Int32] |
지정한 인덱스에 있는 요소를 가져오거나 설정합니다. (다음에서 상속됨 Collection<T>) |
| Items |
IList<T>을 둘러싸는 Collection<T> 래퍼를 가져옵니다. (다음에서 상속됨 Collection<T>) |
| RaiseListChangedEvents |
목록에서 항목을 추가하거나 제거하면 ListChanged 이벤트가 발생하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| SortDirectionCore |
목록이 정렬되는 방향을 가져옵니다. |
| SortPropertyCore |
정렬 기능이 파생 클래스에서 구현되었으면 목록의 정렬에 사용되는 속성 설명자를 가져오고, 그렇지 않으면 |
| SupportsChangeNotificationCore |
ListChanged 이벤트가 사용되는지 여부를 나타내는 값을 가져옵니다. |
| SupportsSearchingCore |
목록에서 검색 기능을 지원하는지 여부를 나타내는 값을 가져옵니다. |
| SupportsSortingCore |
목록에서 정렬 기능을 지원하는지 여부를 나타내는 값을 가져옵니다. |
메서드
| Add(T) |
개체를 Collection<T>의 끝 부분에 추가합니다. (다음에서 상속됨 Collection<T>) |
| AddNew() |
컬렉션에 새 항목을 추가합니다. |
| AddNewCore() |
컬렉션의 끝에 새 항목을 추가합니다. |
| ApplySortCore(PropertyDescriptor, ListSortDirection) |
파생 클래스에서 재정의되면 항목을 정렬하고, 그렇지 않으면 NotSupportedException을 throw합니다. |
| CancelNew(Int32) |
보류 중인 새 항목을 삭제합니다. |
| Clear() |
Collection<T>에서 요소를 모두 제거합니다. (다음에서 상속됨 Collection<T>) |
| ClearItems() |
컬렉션에서 모든 요소를 제거합니다. |
| Contains(T) |
Collection<T>에 요소가 있는지 여부를 확인합니다. (다음에서 상속됨 Collection<T>) |
| CopyTo(T[], Int32) |
대상 배열의 지정된 인덱스에서 시작하여 전체 Collection<T>을 호환되는 1차원 Array에 복사합니다. (다음에서 상속됨 Collection<T>) |
| EndNew(Int32) |
보류 중인 새 항목을 컬렉션에 커밋합니다. |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object) |
| FindCore(PropertyDescriptor, Object) |
파생 클래스에서 검색 기능이 구현되었으면 지정된 값을 가진 지정된 속성 설명자가 있는 항목의 인덱스를 검색하고, 그렇지 않으면 NotSupportedException을 발생시킵니다. |
| GetEnumerator() |
Collection<T>를 반복하는 열거자를 반환합니다. (다음에서 상속됨 Collection<T>) |
| GetHashCode() |
기본 해시 함수로 작동합니다. (다음에서 상속됨 Object) |
| GetType() |
현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object) |
| IndexOf(T) |
지정된 개체를 검색하고, 전체 Collection<T>에서 처음으로 검색한 개체의 인덱스(0부터 시작)를 반환합니다. (다음에서 상속됨 Collection<T>) |
| Insert(Int32, T) |
Collection<T>의 지정된 인덱스에 요소를 삽입합니다. (다음에서 상속됨 Collection<T>) |
| InsertItem(Int32, T) |
지정된 항목을 목록의 지정된 인덱스에 삽입합니다. |
| MemberwiseClone() |
현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| OnAddingNew(AddingNewEventArgs) |
AddingNew 이벤트를 발생시킵니다. |
| OnListChanged(ListChangedEventArgs) |
ListChanged 이벤트를 발생시킵니다. |
| Remove(T) |
Collection<T>에서 맨 처음 발견되는 특정 개체를 제거합니다. (다음에서 상속됨 Collection<T>) |
| RemoveAt(Int32) |
Collection<T>의 지정된 인덱스에 있는 요소를 제거합니다. (다음에서 상속됨 Collection<T>) |
| RemoveItem(Int32) |
지정된 인덱스에서 항목을 제거합니다. |
| RemoveSortCore() |
정렬 기능이 파생 클래스에서 구현되었으면 ApplySortCore(PropertyDescriptor, ListSortDirection)를 사용하여 적용된 정렬을 제거하고, 그렇지 않으면 NotSupportedException을 발생시킵니다. |
| ResetBindings() |
ListChanged 형식의 Reset 이벤트를 발생시킵니다. |
| ResetItem(Int32) |
지정된 위치에 있는 항목에 대해 ListChanged 형식의 ItemChanged 이벤트를 발생시킵니다. |
| SetItem(Int32, T) |
지정된 인덱스에 있는 항목을 지정된 항목으로 바꿉니다. |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
이벤트
| AddingNew |
항목이 목록에 추가되기 전에 발생합니다. |
| ListChanged |
목록이나 목록의 항목이 변경될 때 발생합니다. |
명시적 인터페이스 구현
확장 메서드
적용 대상
추가 정보
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기