BindingList<T>.AddNew 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
컬렉션에 새 항목을 추가합니다.
public:
T AddNew();public T AddNew();member this.AddNew : unit -> 'TPublic Function AddNew () As T반환
목록에 추가된 항목입니다.
예외
예제
다음 코드 예제에서는 메서드를 사용 하는 방법을 보여 줍니다 AddNew . BindingList<T>; 전체 예제는 클래스 개요 항목을 참조 BindingList<T> 하세요.
// Add the new part unless the part number contains
// spaces. In that case cancel the add.
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";
}
}
' 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
설명
메서드는 AddNew 속성이 나타내는 컬렉션에 새 항목을 추가합니다 Items . 새 항목을 추가하려면 다음 논리가 사용됩니다.
AddingNew 이벤트가 자동으로 발생합니다.
이 이벤트는 프로그래밍 방식으로 처리하여 새 사용자 지정 항목을 생성할 수 있습니다. 이 작업은 매개 변수의 AddingNewEventArgs 속성을 새 항목으로 NewObject 설정하여 이벤트 처리기에서 수행됩니다.
그렇지 않으면 새 항목이 해당 공용 매개 변수 없는 생성자를 통해 자동으로 만들어집니다.
새 항목의 위치는 추적되지만 다음 조건 중 하나가 충족될 때까지 목록에 추가되지 않습니다.
항목은 호출에 의해 명시적으로 커밋됩니다 EndNew.
항목의 삽입 또는 제거와 같이 목록 내용을 변경한 다른 작업에서 항목을 암시적으로 커밋합니다.
반대로 항목이 CancelNew 커밋되기 전에 메서드를 호출하면 새 항목이 삭제됩니다.
이 메서드는 새 항목이 ListChanged 커밋되면 이벤트를 발생합니다.
