BindingList<T>.AllowNew Eigenschaft

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Quelle:

BindingList.cs

Ruft einen Wert ab, der angibt, ob der Liste mithilfe der AddNew()-Methode neue Elemente hinzugefügt werden können.

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

Boolean

true, wenn der Liste mithilfe der AddNew()-Methode neue Elemente hinzugefügt werden können, andernfalls false. Der Standardwert hängt von dem in der Liste enthaltenen zugrunde liegenden Typ ab.

Beispiele

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

    // 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));
    }

' 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 wird standardmäßig auf festgelegt true , wenn der in der Liste enthaltene Typ über einen parameterlosen Konstruktor verfügt oder das AddingNew Ereignis behandelt wird. Wenn das AddingNew Ereignis nicht behandelt wird oder der Listentyp keinen parameterlosen Konstruktor aufweist, wird AllowNew standardmäßig verwendet false.

Wenn AllowNew 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, ob AllowNew oder falseisttrue, können neue Elemente durch explizites Aufrufen AddNew hinzugefügt werden, wenn 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