BindingList<T>.AllowNew Tulajdonság

Definíció

Névtér:

System.ComponentModel

Szerelvények:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Forrás:

BindingList.cs

Beolvas vagy beállít egy értéket, amely jelzi, hogy hozzáadhat-e elemeket a listához a AddNew() metódus használatával.

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

Tulajdonság értéke

Boolean

true ha a metódussal elemeket adhat hozzá a AddNew() listához; falseellenkező esetben. Az alapértelmezett érték a listában található mögöttes típustól függ.

Példák

Az alábbi példakód bemutatja, hogyan állíthatja be a tulajdonságot AllowNew . A teljes példáért tekintse meg az osztály áttekintési témakörét BindingList<T> .

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

Megjegyzések

A AllowNew tulajdonságot általában más összetevők használják annak megállapítására, hogy az új elemek létrehozása engedélyezett-e. AllowNew alapértelmezett érték, true ha a listában szereplő típus paraméter nélküli konstruktort tartalmaz, vagy az AddingNew esemény kezelése megtörtént. Ha az AddingNew esemény kezelése nem történik meg, vagy a listatípus nem rendelkezik paraméter nélküli konstruktorsal, akkor AllowNew az alapértelmezett érték a következő false.

Ha AllowNew explicit módon van beállítva, a beállított értéket mindig a kötött objektumok fogják használni annak megállapításához, hogy új elemeket lehet-e hozzáadni a listához. Ha AllowNew a true listatípus paraméter nélküli konstruktort tartalmaz, vagy falseAddNew az eseményt kezeli, az új elemeket explicit hívással AddingNew lehet hozzáadni. A beállítás AllowNew emellett egy ListChanged típuseseményt Reset is okozhat.

Lásd még

• AddNew()
• AllowEdit
• AllowRemove