BindingList<T>.AllowNew Vlastnost

Definice

Získá nebo nastaví hodnotu označující, zda lze přidat položky do seznamu pomocí AddNew() metody .

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

Hodnota vlastnosti

truepokud můžete přidat položky do seznamu pomocí AddNew() metody ; v opačném případě . false Výchozí hodnota závisí na základním typu obsaženém v seznamu.

Příklady

Následující příklad kódu ukazuje, jak nastavit AllowNew vlastnost . Úplný příklad najdete v tématu s přehledem BindingList<T> třídy.

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

Poznámky

Vlastnost AllowNew je obvykle používána jinými komponentami k určení, zda je vytváření nových položek povoleno. AllowNew Výchozí hodnota je, true pokud typ obsažený v seznamu má konstruktor bez parametrů nebo AddingNew je událost zpracována. Pokud se AddingNew událost nezpracuje nebo pokud typ seznamu nemá konstruktor bez parametrů, je AllowNew výchozí falsehodnota .

Pokud AllowNew je explicitně nastavena, bude hodnota sady vždy použita vázanými objekty k určení, zda mohou být do seznamu přidány nové položky. Ať už AllowNew je true nebo false, nové položky lze přidat explicitním voláním AddNew , pokud typ seznamu má konstruktor bez parametrů nebo AddingNew je událost zpracována. Nastavení navíc způsobí, AllowNew že ListChanged dojde k události typu Reset .

Platí pro

Viz také