IBindingList.AddNew Methode

Definitie

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

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).

Van toepassing op