IBindingList.AddNew Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Adiciona um novo item à lista.
public:
System::Object ^ AddNew();public object AddNew ();public object? AddNew ();abstract member AddNew : unit -> objPublic Function AddNew () As ObjectRetornos
O item adicionado à lista.
Exceções
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).
