ICancelAddNew Arabirim

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kodlar:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Kaynak:

ICancelAddNew.cs

Koleksiyona yeni öğe eklerken işlem özelliği ekler.

public interface class ICancelAddNew

public interface ICancelAddNew

type ICancelAddNew = interface

Public Interface ICancelAddNew

Türetilmiş

System.ComponentModel.BindingList<T>

System.Windows.Forms.BindingSource

Açıklamalar

Arabirimi, ICancelAddNew koleksiyonun genişletilebilir bir şekilde yeni bir öğe eklemesini sağlar. Yeni öğe daha sonra işlenebilir veya geri alınabilir. AddNew Koleksiyonun yöntemi, aşağıdaki işlemler aracılığıyla işlenen öğeyi belirsiz bir şekilde eklemek için kullanılır:

• EndNew yöntemi, bekleyen eklemeyi açıkça taahhüt eder.

• Ekleme, kaldırma veya taşıma gibi başka bir koleksiyon işlemi gerçekleştirmek, bekleyen toplamayı örtük olarak işler.

• CancelNew yöntemi, henüz işlenmemişse bekleyen toplamayı geri alır.

Note

Karmaşık Windows Forms veri bağlama gibi bazı senaryolarda koleksiyon, yeni eklenen öğe dışındaki öğeler için CancelNew veya EndNew çağrıları alabilir. (Her öğe genellikle veri görünümündeki bir satırdır.) Bu çağrıları yoksayın; yalnızca bu öğenin dizini belirtildiğinde yeni öğeyi iptal edin veya işleyin.

Bir öğenin veriye bağlı koleksiyona işlemsel olarak eklenmesine izin veren iki model vardır:

• Eski model doğrudan IBindingList arabirimini uygulayan bir koleksiyona dayanır ve doğrudan System.Windows.Forms.CurrencyManager sınıfı kullanılarak verilere bağlıdır. AddNew sınıfının EndCurrentEdit, CancelCurrentEdit ve System.Windows.Forms.CurrencyManager yöntemleri, yeni öğeler eklemek için işlem desteğinden sorumludur. Ancak bu işlevsellik, arabirim aracılığıyla işlem davranışını destekleyen öğelere IEditableObject bağlıdır. Öğeler bu arabirimi desteklemiyorsa, öğesine yapılan sonraki çağrılardan CancelCurrentEditbağımsız olarak öğe her zaman listeye eklenir.

• Daha yeni model, ve BindingList<T> arabirimlerini uygulayan genel IBindingList sınıf aracılığıyla daha sağlam bir veri bağlama senaryoyu ICancelAddNew destekler. Bu durumda işlem desteği doğrudan koleksiyon tarafından BindingList<T> yönetilir.

Yöntemler

Name	Description
CancelNew(Int32)	Koleksiyondan bekleyen yeni bir öğeyi atar.
EndNew(Int32)	Bekleyen yeni bir öğeyi koleksiyona işler.

Ayrıca bkz.

• IBindingList
• CurrencyManager
• IEditableObject
• BindingList<T>