BindingList<T>.AllowNew Özellik

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kodlar:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Kaynak:

BindingList.cs

yöntemini kullanarak AddNew() listeye öğe ekleyip ekleyemeyeceğinizi belirten bir değer alır veya ayarlar.

public:
 property bool AllowNew { bool get(); void set(bool value); };

public bool AllowNew { get; set; }

member this.AllowNew : bool with get, set

Public Property AllowNew As Boolean

Özellik Değeri

Boolean

true yöntemiyle AddNew() listeye öğe ekleyebiliyorsanız; değilse, false. Varsayılan değer, listede yer alan temel türe bağlıdır.

Örnekler

Aşağıdaki kod örneğinde özelliğin nasıl ayarlanacağı gösterilmektedir AllowNew . Tam örnek için sınıfa genel bakış konusuna BindingList<T> bakın.

// Declare a new BindingListOfT with the Part business object.
BindingList<Part> listOfParts;
void InitializeListOfParts()
{
    // Create the new BindingList of Part type.
    listOfParts = new BindingList<Part>
    {
        // Allow new parts to be added, but not removed once committed.        
        AllowNew = true,
        AllowRemove = false,

        // Raise ListChanged events when new parts are added.
        RaiseListChangedEvents = true,

        // Do not allow parts to be edited.
        AllowEdit = false
    };

    // Add a couple of parts to the list.
    listOfParts.Add(new Part("Widget", 1234));
    listOfParts.Add(new Part("Gadget", 5647));
}

' 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

Açıklamalar

AllowNew özelliği genellikle yeni öğelerin oluşturulmasına izin verilip verilmediğini belirlemek için diğer bileşenler tarafından kullanılır. AllowNew true, listede yer alan türün parametresiz bir oluşturucuya sahip olması veya AddingNew olayın işlenmesi durumunda varsayılan olarak ayarlanır. AddingNew Olay işlenmediyse veya liste türü parametresiz bir oluşturucuya sahip değilse, AllowNew varsayılan olarak olurfalse.

Açıkça ayarlanırsa AllowNew , küme değeri her zaman bağlı nesneler tarafından listeye yeni öğelerin eklenip eklenebileceğini belirlemek için kullanılır. veya olsunAllowNew, liste türü parametresiz bir oluşturucuya sahipse veya olay işlenirse açıkça çağrılarak AddingNewAddNew yeni öğeler falseeklenebilir.true Buna ek olarak, ayar AllowNew türündeki Reset bir ListChanged olayın oluşmasına neden olur.

Ayrıca bkz.

• AddNew()
• AllowEdit
• AllowRemove