BindingList<T>.AllowNew Eigenschaft

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

Eigenschaftswert

true wenn Sie der Liste Elemente mit der AddNew() Methode hinzufügen können; andernfalls false. Der Standardwert hängt vom zugrunde liegenden Typ in der Liste ab.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AllowNew Eigenschaft festgelegt wird. Das vollständige Beispiel finden Sie im BindingList<T> Thema "Klassenübersicht".

// 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

Hinweise

Die AllowNew Eigenschaft wird in der Regel von anderen Komponenten verwendet, um zu bestimmen, ob die Erstellung neuer Elemente zulässig ist. AllowNew standardmäßig, wenn der in der Liste enthaltene true Typ einen parameterlosen Konstruktor aufweist oder das AddingNew Ereignis behandelt wird. Wenn das AddingNew Ereignis nicht behandelt wird oder der Listentyp keinen parameterlosen Konstruktor aufweist, wird AllowNew standardmäßig auf false.

Wenn AllowNew der Wert explizit festgelegt ist, wird der Setwert immer von gebundenen Objekten verwendet, um zu bestimmen, ob der Liste neue Elemente hinzugefügt werden können. Unabhängig davon truefalse, ob AllowNew neue Elemente hinzugefügt werden können, indem explizit aufgerufen AddNew wird, ob der Listentyp über einen parameterlosen Konstruktor verfügt oder das AddingNew Ereignis behandelt wird. Darüber hinaus bewirkt die Einstellung AllowNew , dass ein ListChanged Ereignis vom Typ Reset auftritt.

Weitere Informationen

• AddNew()
• AllowEdit
• AllowRemove