IBindingList.AddNew IBindingList.AddNew IBindingList.AddNew IBindingList.AddNew Method

Definição

Adiciona um novo item à lista.Adds a new item to the list.

public:
 System::Object ^ AddNew();
public object AddNew ();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object

Retornos

O item adicionado à lista.The item added to the list.

Exceções

Comentários

Esse método é suportado somente se AllowNew for true; caso contrário, NotSupportedException um será lançado.This method is supported only if AllowNew is true; otherwise, a NotSupportedException is thrown.

A implementação desse método significa que IBindingList a lista deve entender o tipo de objetos a serem adicionados à lista e deve entender como criar uma nova instância desse tipo.Implementing this method means that the IBindingList list must understand the type of objects to add to the list and must understand how to create a new instance of that type. Por exemplo, se você tiver uma coleção de myCustomer objetos, o AddNew método deverá adicionar um novo myCustomer objeto à lista.For example, if you have a collection of myCustomer objects, the AddNew method should add a new myCustomer object to the list.

Observação

Se os objetos nessa lista implementarem a IEditableObject interface, chamar o CancelEdit método deverá descartar um objeto, não adicioná-lo à lista quando o objeto tiver sido criado AddNew usando o método.If the objects in this list implement the IEditableObject interface, calling the CancelEdit method should discard an object, not add it to the list, when the object was created using the AddNew method. O objeto só deve ser adicionado à lista quando o IEditableObject.EndEdit método é chamado.The object should only be added to the list when the IEditableObject.EndEdit method is called. Portanto, você deve sincronizar o objeto e a lista com cuidado.Therefore, you must synchronize the object and the list carefully.

Quando esse método é chamado, você deve gerar um ListChanged evento com a ItemAdded enumeração que está carregando o índice apropriado.When this method is called, you should raise a ListChanged event with the ItemAdded enumeration carrying the appropriate index. A linha adicionada está em um estado em que pressionar ESC em DataGridView um controle pode remover a nova linha.The added row is in a state where hitting Esc on a DataGridView control can remove the new row. Gerar o ListChanged evento com a ItemAdded enumeração uma segunda vez nessa linha indica que o item agora é uma linha normal (não está no novo estado).Raising the ListChanged event with the ItemAdded enumeration a second time on this row indicates that the item is now a normal row (not in new state).

Aplica-se a