IBindingList.AddNew Método

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Adiciona um novo item à lista.

public:
 System::Object ^ AddNew();

public object? AddNew ();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Retornos

Object

O item adicionado à lista.

Exceções

NotSupportedException

AllowNew é false.

Comentários

Esse método só terá suporte se AllowNew for true; caso contrário, um NotSupportedException será gerado.

Implementar esse método significa que a IBindingList lista deve entender o tipo de objetos a serem adicionados à lista e deve entender como criar uma nova instância desse tipo. Por exemplo, se você tiver uma coleção de myCustomer objetos, o AddNew método deverá adicionar um novo myCustomer objeto à lista.

Observação

Se os objetos nesta lista implementarem a IEditableObject interface , chamar o CancelEdit método deverá descartar um objeto, não adicioná-lo à lista, quando o objeto foi criado usando o AddNew método . O objeto só deve ser adicionado à lista quando o IEditableObject.EndEdit método é chamado. Portanto, você deve sincronizar o objeto e a lista cuidadosamente.

Quando esse método é chamado, você deve gerar um ListChanged evento com a ItemAdded enumeração carregando o índice apropriado. A linha adicionada está em um estado em que bater em Esc em um DataGridView controle pode remover a nova linha. Gerar o ListChanged evento com a ItemAdded enumeração uma segunda vez nessa linha indica que o item agora é uma linha normal (não em novo estado).