IBindingList.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 lijst.
public:
System::Object ^ AddNew();
public object? AddNew();
public object AddNew();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object
Retouren
Het item dat aan de lijst is toegevoegd.
Uitzonderingen
AllowNew is false.
Opmerkingen
Deze methode wordt alleen ondersteund als AllowNew dat wel het enige is true; anders wordt er een NotSupportedException gegenereerd.
Het implementeren van deze methode betekent dat de IBindingList lijst het type objecten moet begrijpen dat moet worden toegevoegd aan de lijst en moet begrijpen hoe u een nieuw exemplaar van dat type maakt. Als u bijvoorbeeld een verzameling myCustomer objecten hebt, moet de AddNew methode een nieuw myCustomer object toevoegen aan de lijst.
Note
Als de objecten in deze lijst de IEditableObject interface implementeren, moet het aanroepen van de CancelEdit methode een object negeren, niet toevoegen aan de lijst, wanneer het object is gemaakt met behulp van de AddNew methode. Het object mag alleen worden toegevoegd aan de lijst wanneer de IEditableObject.EndEdit methode wordt aangeroepen. Daarom moet u het object en de lijst zorgvuldig synchroniseren.
Wanneer deze methode wordt aangeroepen, moet u een ListChanged gebeurtenis genereren met de ItemAdded opsomming die de juiste index bevat. De toegevoegde rij heeft een status waarin op Esc op een DataGridView besturingselement de nieuwe rij kan worden verwijderd. Als u de ListChanged gebeurtenis met de ItemAdded opsomming een tweede keer op deze rij opgeeft, geeft u aan dat het item nu een normale rij is (niet in nieuwe staat).