BindingList<T>.AddNew Methode
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 voegt u een nieuw item toe aan de verzameling.
public:
T AddNew();public T AddNew();member this.AddNew : unit -> 'TPublic Function AddNew () As TRetouren
Het item dat aan de lijst is toegevoegd.
Uitzonderingen
De eigenschap AllowNew is ingesteld op false.
– of –
Er is geen openbare parameterloze constructor gevonden voor het huidige itemtype.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de AddNew methode gebruikt. BindingList<T>. Zie het overzichtsonderwerp van de klas voor het BindingList<T> volledige voorbeeld.
// Add the new part unless the part number contains
// spaces. In that case cancel the add.
void button1_Click(object sender, EventArgs e)
{
Part newPart = listOfParts.AddNew();
if (newPart.PartName.Contains(' '))
{
_ = MessageBox.Show("Part names cannot contain spaces.");
listOfParts.CancelNew(listOfParts.IndexOf(newPart));
}
else
{
textBox2.Text = randomNumber.Next(9999).ToString();
textBox1.Text = "Enter part name";
}
}
' Add the new part unless the part number contains
' spaces. In that case cancel the add.
Private Sub button1_Click(ByVal sender As Object, _
ByVal e As EventArgs) Handles button1.Click
Dim newPart As Part = listOfParts.AddNew()
If newPart.PartName.Contains(" ") Then
MessageBox.Show("Part names cannot contain spaces.")
listOfParts.CancelNew(listOfParts.IndexOf(newPart))
Else
textBox2.Text = randomNumber.Next(9999).ToString()
textBox1.Text = "Enter part name"
End If
End Sub
Opmerkingen
Met AddNew de methode wordt een nieuw item toegevoegd aan de verzameling die wordt vertegenwoordigd door de Items eigenschap. Als u een nieuw item wilt toevoegen, wordt de volgende logica gebruikt:
De AddingNew gebeurtenis wordt automatisch gegenereerd.
Deze gebeurtenis kan programmatisch worden verwerkt om een nieuw aangepast item te maken. Dit wordt bereikt in de gebeurtenis-handler door de NewObject eigenschap van de AddingNewEventArgs parameter in te stellen op het nieuwe item.
Anders wordt het nieuwe item automatisch gemaakt via de openbare parameterloze constructor.
De positie van het nieuwe item wordt bijgehouden, maar het wordt pas toegevoegd aan de lijst als aan een van de volgende voorwaarden wordt voldaan:
Het item wordt expliciet vastgelegd door een aanroep naar EndNew.
Het item wordt impliciet doorgevoerd door een andere bewerking die de inhoud van de lijst heeft gewijzigd, zoals een invoeging of verwijdering van een item.
Als u daarentegen de CancelNew methode aanroept voordat het item wordt doorgevoerd, wordt het nieuwe item verwijderd.
Met deze methode wordt de ListChanged gebeurtenis gegenereerd wanneer het nieuwe item wordt doorgevoerd.
