Compartilhar via


IBindingList.AddNew Método

Definição

Adiciona um novo item à lista.

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

Retornos

O item adicionado à lista.

Exceções

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

Aplica-se a