BindingList<T>.AllowNew Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of u items aan de lijst kunt toevoegen met behulp van de AddNew() methode.
public:
property bool AllowNew { bool get(); void set(bool value); };public bool AllowNew { get; set; }member this.AllowNew : bool with get, setPublic Property AllowNew As BooleanWaarde van eigenschap
true als u items met de AddNew() methode aan de lijst kunt toevoegen, falseanders. De standaardwaarde is afhankelijk van het onderliggende type in de lijst.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de AllowNew eigenschap instelt. Zie het overzichtsonderwerp van de klas voor het BindingList<T> volledige voorbeeld.
// 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
Opmerkingen
De AllowNew eigenschap wordt doorgaans door andere onderdelen gebruikt om te bepalen of het maken van nieuwe items is toegestaan.
AllowNew wordt standaard ingesteld true als het type in de lijst een parameterloze constructor heeft of als de AddingNew gebeurtenis wordt verwerkt. Als de AddingNew gebeurtenis niet wordt verwerkt of als het lijsttype geen constructor zonder parameters heeft, wordt AllowNew standaard ingesteld op false.
Als AllowNew deze expliciet is ingesteld, wordt de ingestelde waarde altijd gebruikt door afhankelijke objecten om te bepalen of er nieuwe items aan de lijst kunnen worden toegevoegd. Of AllowNew het nu gaat true of falsenieuwe items kunnen worden toegevoegd door expliciet aan te roepen AddNew als het lijsttype een parameterloze constructor heeft of dat de AddingNew gebeurtenis wordt verwerkt. Bovendien zorgt de instelling AllowNew ervoor dat een ListChanged gebeurtenis van het type Reset plaatsvindt.
