BindingList<T>.AllowNew Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
true
pokud 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í false
hodnota .
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 .