This is a shorter post than the one I just previewed but didn't send.  But it is a newbie question anyway.

WHen you do BusinessObject.Add(), does that clear out the business object and then add a new row? Or do I need to do BUsinessObject.Clear() first if I want to clear all the values out?

Just double checking.

Thanks,

Marcel

.Add will add a new row to the underlying datatable. It does not clear out the current data. Use this method when you want to add a new row. This will also update the EditingState of the BO and update any bound controls to the BO. Use NewRow() if you are just doing something programmatically (see the "Adding Editing & Deleting Records" help topic for more info).



.Clear clears all the data in the BO and resets the underlying datatable (thus if you add/deleted any columns, they are restored).



Hope that clears things up for you!

Yep, just like Greg says, Clear() reverts the business object back to square 1.  So, if you have 10 records in the BO, and you call .Add(), it will have 11, if you call Clear(), it will have 0.  I think part of your confusion might come from the fact that a BO can hold multiple records; if you are thinking that it can only hold one, then yeah, thinking you need to clear it before using it again would certaily make sense

Thanks for your support, guys!

Just to make sure I got it - what is the recommened way to handle the following scenario?

I have a parent/child bo.

The user enters one parent record, and then he adds let's say 5 child records before he clicks finish (like with a wizard). For example I set up one company with 5 contacts.  Now after adding the five contacts, the user discover that contact #3 shouldn't have been added, so he removes him from the list. Finally the user is satisfied with the result and he clicks finish and the parent/child records are saved to the database.

To add a new record I simply use the add method.  What about deleting a record from that bo.  Simply use delete? How will that affect the final save?

Again I appreciate your help, and your framework has already saved me a considerable amount of work.

Thanks,

Marcel