IBindingList.AddNew Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Adiciona um novo item à lista.
public:
System::Object ^ AddNew();public object? AddNew();public object AddNew();abstract member AddNew : unit -> objPublic Function AddNew () As ObjectDevoluções
O item adicionado à lista.
Exceções
AllowNew é false.
Observações
Este método é suportado apenas se AllowNew for true; caso contrário, a NotSupportedException é lançado.
Implementar este método significa que a IBindingList lista deve compreender o tipo de objetos a adicionar à lista e deve saber como criar uma nova instância desse tipo. Por exemplo, se tiver uma coleção de myCustomer objetos, o AddNew método deve adicionar um novo myCustomer objeto à lista.
Note
Se os objetos desta lista implementarem a IEditableObject interface, chamar o CancelEdit método deve 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. Por isso, deve sincronizar cuidadosamente o objeto e a lista.
Quando este método é chamado, deve criar um ListChanged evento com a ItemAdded enumeração a transportar o índice apropriado. A linha adicionada está num estado em que carregar em Esc num DataGridView controlo pode remover a nova linha. Elevar o ListChanged evento com a ItemAdded enumeração uma segunda vez nesta linha indica que o item é agora uma linha normal (não está em novo estado).
